Turbine free variable

The turbine object is a “free variable” within the scope of your extension’s library modules. It provides information and utilities specific to the Adobe Experience Platform tag runtime and is always available to library modules without using require().

buildInfo

console.log(turbine.buildInfo.turbineBuildDate);

turbine.buildInfo is an object containing build information about the current tag runtime library.

{
    turbineVersion: "14.0.0",
    turbineBuildDate: "2016-07-01T18:10:34Z",
    buildDate: "2016-03-30T16:27:10Z"
}

environment

console.log(turbine.environment.stage);

turbine.environment is an object containing information about the environment that the library is deployed on.

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

debugEnabled

A boolean value indicating whether tag debugging is currently enabled.

If you are simply attempting to log messages, it’s unlikely you will need to use this. Instead, always log messages using turbine.logger to ensure your messages are only printed to the console when tag debugging is enabled.

getDataElementValue

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

Returns the value of a data element.

getExtensionSettings get-extension-settings

var extensionSettings = turbine.getExtensionSettings();

Returns the settings object that was last saved from the extension configuration view.

Please note that values within the returned settings objects may be coming from data elements. Because of this, calling getExtensionSettings() at different times may yield different results if the values of the data elements have changed. To get the most up-to-date values, please wait as long as possible before calling getExtensionSettings().

getHostedLibFileUrl get-hosted-lib-file

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

The hostedLibFiles property can be defined inside the extension manifest in order to host various files along with the tag runtime library. This module returns the URL where the given library file is hosted.

getSharedModule shared

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

Retrieves a module that has been shared from another extension. If no matching module is found, undefined will be returned. See Implementing Shared Modules for more information regarding shared modules.

logger

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

The logging utility is used to log messages to the console. Messages will only show in the console if debugging is turned on by the user. The recommended way to turn on debugging is to use the Adobe Experience Platform Debugger. As an alternative, the user can run the following command _satellite.setDebug(true) inside the browser developer console. The logger has the following methods:

onDebugChanged

By passing a callback function into turbine.onDebugChanged, tags will call your callback whenever debugging is toggled. Tags will pass a boolean to the callback function which will be true if debugging was enabled or false if debugging was disabled.

If you are simply attempting to log messages, it’s unlikely you will need to use this. Instead, always log messages using turbine.logger and tags will ensure your messages are only printed to the console when tag debugging is enabled.

propertySettings property-settings

console.log(turbine.propertySettings.domains);

An object containing the following settings which are defined by the user for the property of the current tag runtime library: