The brilliantly simple, babel-less, bundle-less ECMAScript module loader.
esm is the world’s most advanced ECMAScript module loader.
This fast, production ready, zero dependency loader is all you need to support
ECMAScript modules in Node 6+. See the release post
and video for details!
Install
New projects
Run npm init esm or yarn create esm.
:bulb: Use the -y flag to answer “yes” to all prompts.
Existing projects
Run npm i esm or yarn add esm.
Getting started
There are two ways to enable esm.
Enable esm for packages:
Use esm to load the main ES module and export it as CommonJS.
index.js
// Set options as a parameter, environment variable, or rc file.require = require("esm")(module/*, options*/)module.exports = require("./main.js")
main.js
// ESM syntax is supported.export {}
:bulb: These files are automagically created with npm init esm or yarn create esm.
Enable esm for local runs:
node -r esm main.js
:bulb: Omit the filename to enable in the REPL.
Features
:clap: By default, :100: percent CJS interoperability is enabled so you can get stuff done.
:lock: .mjs files are limited to basic functionality without support for esm options.
Out of the box esm just works, no configuration necessary, and supports: