Global JavaScript objects and functions

The following global functions and objects are available in the Enonic XP framework.

App

The globally available app object holds information about the contextual app it was delivered from. It has the following properties:

app.name
The name of the application, as defined in its gradle configuration.
app.version
Version of the application, as defined in its gradle configuration.
app.config
Values from the application’s configuration file. This can be set using $XP_HOME/config/<app.name>.cfg. Every time the configuration is changed the app is restarted.

Examples:

// Get application name
var name = app.name;  // com.enonic.app.superhero

// Get application version
var version = app.version;  // 1.2.0

// Get some config from the <app.name>.cfg file
var myKey = app.config.secretkey; // Reads the string stored in the "secretkey" property

Log

This globally available log object holds the logging methods. It’s one method for each log level and takes the same number of parameters.

log.debug(message[, args])
Arguments:
  • message (string) – Message to log as a debug-level message.
  • args (array) – Optional arguments used in message format.
log.info(message[, args])
Arguments:
  • message (string) – Message to log as an info-level message.
  • args (array) – Optional arguments used in message format.
log.warning(message[, args])
Arguments:
  • message (string) – Message to log as a warning-level message.
  • args (array) – Optional arguments used in message format.
log.error(message[, args])
Arguments:
  • message (string) – Message to log as an error-level message.
  • args (array) – Optional arguments used in message format.

Examples:

// Log a simple message
log.debug('Hello World');

// Log a formatting message
log.info('Hello %s', 'World');

// Log a formatting message
log.warning('%s %s', 'Hello', 'World');

// Log using the built-in JSON converter
log.error('My JSON %s', object );

Resolve()

This globally available function resolves a fully qualified path to a local resource based on the current location. It does not check if a resource exists at the specified path. This function supports both relative (with dot-references) and absolute paths.

resolve(path)
Arguments:
  • path (string) – Path to resolve using current location.
Returns:

The fully qualified resource path of the location.

Examples:

// Absolute path
var path1 = resolve('/views/myview.html');

// Relative path - in this case, the resource must be in the same folder
var path2 = resolve('myview.html');

// Relative path (same as above)
var path3 = resolve('./myview.html');

// Relative path - resource is one level up
var path4 = resolve('../myview.html');

Require()

This globally available function will load a JavaScript file and return the exports as objects. The function implements parts of the CommonJS Modules Specification.

require(path)
Arguments:
  • path (string) – Path to the JavaScript to load.
Returns:

The loaded JavaScript object exports.

Examples:

// Absolute path
var lib1 = require('/lib/mylib.js');

// Relative path
var lib2 = require('mylib');

// Relative path (same as above)
var lib3 = require('./mylib.js');

// Relative path
var lib4 = require('../mylib');

If the path is relative then it will start looking for the file from the local directory. If the file is not found there, it will start scanning in parent directories that have a /lib folder until it reaches the resources/ folder. The file extension .js is not required.

Exports

The globally available exports keyword is used to expose functionality from a given JavaScript file (controllers, libraries etc). This is part of the require.js spec.

Simply use the exports keyword to expose functionality from any JavaScript file.

Double underscore __

The double underscore is available in any server-side JavaScript code and is used for wrapping Java objects in a JavaScript object. Read more about Invoking Java.