Turbine 自由变量

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

buildInfo

console.log(turbine.buildInfo.turbineBuildDate);

turbine.buildInfo 是一个对象,其中包含有关当前 Platform Launch 运行时库的版本信息。

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

debugEnabled

当前是否启用 Platform Launch 调试功能。

如果您只是尝试记录消息,则可能不需要使用此功能。相反,当启用 Platform Launch 调试功能后,将始终使用 turbine.logger 来记录消息,并且 Platform Launch 会确保将消息只打印到控制台。

getDataElementValue

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

返回数据元素的值。

getExtensionSettings

var extensionSettings = turbine.getExtensionSettings();

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

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

getHostedLibFileUrl

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

为了将各种文件与 Platform Launch 运行时库一起托管,可以在扩展清单中定义 hostedLibFiles 属性。此模块会返回托管给定库文件的 URL。

getSharedModule

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

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

logger

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

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

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

onDebugChanged

每当切换调试功能时,Platform Launch 会通过将回调函数传递到 turbine.onDebugChanged 来调用您的回调。Platform Launch 将向回调函数传递一个布尔值,如果启用了调试功能,该值为 true;如果禁用了调试功能,该值则为 false。

如果您只是尝试记录消息,则可能不需要使用此功能。相反,当启用 Platform Launch 调试功能后,将始终使用 turbine.logger 来记录消息,并且 Platform Launch 会确保将消息只打印到控制台。

propertySettings

console.log(turbine.propertySettings.domains);

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

  • propertySettings.domains: Array<String>

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

  • propertySettings.undefinedVarsReturnEmpty: boolean

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

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now