Turbine 自由变量

NOTE
Adobe Experience Platform Launch已更名为Adobe Experience Platform中的一套数据收集技术。 因此,产品文档中的术语有一些改动。有关术语更改的综合参考,请参阅以下文档

turbine 对象是扩展库模块范围内的“自由变量”。它提供了特定于Adobe Experience Platform标记运行时的信息和实用程序,并且始终可供库模块使用,而无需借助 require().

buildInfo

console.log(turbine.buildInfo.turbineBuildDate);

turbine.buildInfo 是一个对象,其中包含有关当前标记运行时库的生成信息。

{
    turbineVersion: "14.0.0",
    turbineBuildDate: "2016-07-01T18:10:34Z",
    buildDate: "2016-03-30T16:27:10Z"
}
属性
描述
turbineVersion
当前库中使用的 Turbine 版本。
turbineBuildDate
生成容器内使用的 Turbine 版本的 ISO 8601 日期。
buildDate
生成当前库的 ISO 8601 日期。

environment

console.log(turbine.environment.stage);

turbine.environment 是一个对象,其中包含有关库部署到的环境的信息。

{
    id: "ENbe322acb4fc64dfdb603254ffe98b5d3",
    stage: "development"
}
属性
描述
id
环境的ID。
stage
生成此库的环境。可能的值包括 developmentstaging、和 production.

debugEnabled

一个布尔值,指示当前是否启用标记调试。

如果您只是尝试记录消息,则可能不需要使用此功能。相反,始终使用以下方式记录消息 turbine.logger 以确保在启用了标记调试的情况下仅将消息打印到控制台。

getDataElementValue

console.log(turbine.getDataElementValue(dataElementName));

返回数据元素的值。

getExtensionSettings get-extension-settings

var extensionSettings = turbine.getExtensionSettings();

返回上次从扩展配置视图中保存的设置对象。

请注意,返回的设置对象中的值可能来自数据元素。因此,如果数据元素的值发生变化,那么在不同时间调用 getExtensionSettings() 可能会产生不同的结果。要获得最新的值,请在调用之前尽可能等待一段时间 getExtensionSettings().

getHostedLibFileUrl get-hosted-lib-file

var loadScript = require('@adobe/reactor-load-script');
loadScript(turbine.getHostedLibFileUrl('AppMeasurement.js')).then(function() {
  // Do something ...
})

Hostedlibfiles 属性可以在扩展清单中定义,以便与标记运行时库一起托管各种文件。 此模块会返回托管给定库文件的 URL。

getSharedModule shared

var mcidInstance = turbine.getSharedModule('adobe-mcid', 'mcid-instance');

检索从其他扩展共享的模块。 如果找不到匹配的模块,则返回 undefined。有关共享模块的更多信息,请参阅实施共享模块

logger

turbine.logger.error('Error!');

日志记录实用程序用于将消息记录到控制台。 仅当用户开启调试功能时,消息才会显示在控制台中。开启调试功能的推荐方法是 Adobe Experience Platform Debugger. 作为替代方法,用户可以运行以下命令 _satellite.setDebug(true) 在浏览器开发人员控制台中。 该日志记录器包括以下方法:

  • logger.log(message: string):将消息记录到控制台。
  • logger.info(message: string):将信息性消息记录到控制台。
  • logger.warn(message: string):将警告消息记录到控制台。
  • logger.error(message: string):将错误消息记录到控制台。
  • logger.debug(message: string):将调试消息记录到控制台。(仅当在浏览器控制台中启用 verbose 日志记录时才可见。)
  • logger.deprecation(message: string):将警告消息记录到控制台,无论用户是否启用了标记调试。

onDebugChanged

通过将回调函数传递到 turbine.onDebugChanged,标记将在切换调试时调用您的回调。 标记将向回调函数传递一个布尔值,如果启用了调试,该值为true;如果禁用了调试,该值则为false。

如果您只是尝试记录消息,则可能不需要使用此功能。相反,始终使用以下方式记录消息 turbine.logger 和标记可确保在启用标记调试功能后,消息仅会打印到控制台。

propertySettings property-settings

console.log(turbine.propertySettings.domains);

一个包含以下设置的对象,这些设置是用户为当前标记运行时库的属性定义的:

  • propertySettings.domains: Array<String>

    一个由属性涵盖的域数组。

  • propertySettings.undefinedVarsReturnEmpty: boolean

    扩展开发者不应关注此设置。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743