Write a debug message to the current Report.

Write an information message to the current Report.

Write a warning message to the current Report.

Write an error message to the current Report.

Write an error message to the current Report and abort the build script execution.

Enable the task package name.

Execute the supplied script in the current script engine and return the result. The f argument is interpreted by InterpretAsReadableFileStrategy. JavaScript by itself lacks an import function.

Since include uses interpreted arguments, it can use files from a variety of locations. For large projects, for instance, it may be useful to distribute common utility functions in a Zip file.

// Import the org.entityfs.zip Java package so that we don't have to qualify
// the ZipFileSystemBuilder class below.
importPackage(Packages.org.entityfs.zip);

// Get a Directory for the root directory of the Zip file
includeRoot = new ZipFileSystemBuilder().
  // Assuming that the script's working directory is an Eclipse workspace
  // directory, get the script archive from the Resources project
  setZipFile(new File("Resources/scripts/common-scripts.zip")).
  create().getRootDirectory();

// Include a couple of script files from the Zip file.
include(Directories.getFile(includeRoot, "common.js"));
include(Directories.getFile(includeRoot, "compile.js"));

The methods of SchmantUtil may be useful when creating paths relative to the currently executing script file.

Log error information from the exception to the error Report level. This can be useful for reporting errors directly in scripts since useful debugging information may otherwise get lost in the JavaScript script engine before it can be logged.

try {
  // ... do things that might go wrong
} catch (e) {
  reportError(e);
}

When calling a varargs method in Java, use a JavaScript array for the arguments.

A JavaScript script cannot call methods named delete on objects. Probably because "delete" is a reserved word in JavaScript. This may also be a problem for other reserved words. See the Core JavaScript reference for a list of all reserved words in JavaScript.

You may run into errors like ReferenceError: "javax" is not defined, where javax may be org, com or any other name of a top level package. These errors occur because the JavaScript interpreter sometimes cannot resolve fully qualified classes, for some reason. A workaround is to prefix all package names with Packages. like this

importPackage(Packages.org.myproject.mypackage);

or

Packages.org.myproject.mypackage.MyClass.doIt(doItArgument);