Use the Node.js agent with ESM
The Contrast Node.js agent provides limited support for using ECMAScript modules (ESM) in Node.js server-side applications. ESM is the official standard format to package JavaScript client-side code and now Node.js provides support for ESM.
There are two ways to run the Contrast Node.js agent if you are using ESM server-side applications.
To explicitly assert that the code you're running is ESM and should be run as such, use the MJS file extension. Learn more about determining a module system wiith file extensions in the Node.js documentation.
When you use an MJS extension, Node.js knows that you've written ESM and will parse your JavaScript as such. The same is true for CJS; Node.js knows that a CJS file extension should run as CommonJS, and will parse your JavaScript as CommonJS.
Otherwise, you can get your Node.js applications to run as ESM rather than CommonJS by including
"type": "module"in your package.json, like this:"main": "index.js", "type": "module",
This specifically tells Node.js to parse your JS files under this
package.jsonas ESM. Otherwise, by default (or when you use"type": "commonjs"), Node.js will parse your JS files as CommonJS.
Note
The Contrast Node.js agent does not support ESM Conditional Exports.
ECMAScript instrumentation is experimental and Contrast requires at least Node.js version 14.15.0 for support.
When instrumenting an application that uses ESM (or a combination of both ESM and CJS), start the application like this:
Usage: node --experimental-loader @contrast/agent/esm.mjs app-main.mjs [agent arguments] -- [app arguments]