Turbine 自由變數

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"
}

environment

console.log(turbine.environment.stage);

turbine.environment是包含程式庫部署所在環境相關資訊的物件。

{
    id: "ENbe322acb4fc64dfdb603254ffe98b5d3",
    stage: "development"
}

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)。 記錄器具有下列方法：

onDebugChanged

將回呼函式傳入turbine.onDebugChanged後，每當切換偵錯功能時，標籤就會呼叫您的回呼。 標籤會將布林值傳至回呼函式，若已啟用偵錯，則值為true；若停用偵錯，則值為false。

如果您只是要記錄訊息，則不太可能需要使用此功能。請一律使用turbine.logger來記錄訊息，標籤將確保您的訊息只會在啟用標籤偵錯時列印到主控台。

propertySettings property-settings

console.log(turbine.propertySettings.domains);

一個物件，其中包含使用者為目前標籤執行階段程式庫的屬性所定義的下列設定：