nodemjs
Run .mjs files from your command line, with all the tweaks from esmod-pmb.
Added features:
- Legacy-resolves module names passed with
-r if they would otherwise
yield the ERR_MODULE_RESOLUTION_LEGACY error.
- Pre-imports all modules listed in env var
NODEMJS_PRELOAD and
npm setting nodemjs-preload (see caveats below).
Multiple module specs can be separated with spaces.
They will be loaded even before the -r pre-imports.
⚠ Incompatible with node.js v20+! ⚠
… because the upstream esm module is no longer maintained.
See issue #2.
API
No.
CLI
$ nodemjs test/uc1st.mjs
uc1st: [ 'Using dummy input', 'Because there were', 'No CLI args' ]
$ ./test/uc1st.mjs foo bar qux
uc1st: [ 'Foo', 'Bar', 'Qux' ]
Setup
npm install --global nodemjs- Make sure you have a node.js (compatible) binary available as the
nodejs command. If you use sane package sources, you probably do.
If you don't, just make a symlink nodejs to node or whatever
it's called on your system.
(If you'd like to argue the supremacy of the more generic node
command name, file an issue, ideally after you've renamed the
Node.js foundation to Node foundation.)
As of 0.1.7, you can configure your favorite nodejs replacement
via the NODEJS_CMD env var.
Known issues
-
Currently no support for setting process.mainModule, see the
upstream bug ticket.
-
npm config caveat:
The nodemjs-preload npm setting
is currently ignored if its value as a string is literally undefined.
If you want to pre-load a module with that name and nothing else,
put it in twice, with a space between.
See also: Duplicate pre-imports.
-
Duplicate pre-imports:
nodemjs currently does not check whether a module you're trying to
pre-import had already been imported before.
Usually node's module cache voids all non-first import attempts
per module, so this won't matter
— unless you use cache-busting modules, in which case you're on your own.
-
REPL:
The REPL isn't upgraded to ESM because esm currently
cannot expose its REPL in a clean and easy way.
-
The invokedAs context property for nodemjsCliMain doesn't work.
-
Needs more/better tests and docs.
License
ISC
