Turbine 自由变量

注意

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 生成此库的环境。可能的值为development、staging和production。

debugEnabled

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

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

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 ...
})

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

getSharedModule

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

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

logger

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

日志记录实用程序用于将消息记录到控制台。 仅当用户开启调试功能时，消息才会显示在控制台中。开启调试功能的推荐方法是使用Adobe Experience Cloud 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

console.log(turbine.propertySettings.domains);

包含以下设置的对象，这些设置由用户为当前标记运行时库的属性定义：

  • propertySettings.domains: Array<String>

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

  • propertySettings.undefinedVarsReturnEmpty: boolean

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

在此页面上