ES2015module detection in Node.js
This project has been archived. For the current state, read up on: https://nodejs.org/api/esm.html
However, some in the community feel that this solution is not cool and ask in-defense-of-.js to reconsider this draft.
By reading this summary, you can ...
ES2015 modulesare part of the
ECMA-262specification. They are also called
ES2015 modulesupport from 1.3.
Chakrabehind a switch.
The EcmaScript TC39 - Technical Commitee is a group of about
20 respected members that work on the specification of EcmaScript (aka.
to work better with Node.js.
The Node Technical Steering Committee is a group of 12 long-term contributors to Node.js that make decisions on the future of Node.js. They decide on how the implementation of ES2016 modules will look like going forward.
ES2016 modules are a unavoidable part of the Node ecosystem, depending on the implementation chosen the work for
every Node.js engineer to update their project will be different. Also developers need to interact with other developers
and as such interoperability is a key-concern for them as well.
ES2016 modules are supposed to be also implemented by browsers. This has not
yet happened but with Chakra being the first to hide it behind a flag it is making quick progress.
Frontend developers though also tend to increasingly use npm packages. As such they are interested in better tooling around such things as
NPM Inc. maintains the system at the center of
Node.js also called NPM. Their stake in this is that people will in future
want to download packages with
ES2015 modules. NPM also
maintains the documentation of the
package.json which plays a
center role in several proposals.
The ES6 module syntax seems like it is just syntax sugar. And if it were
then this discussion would be over for a long time already. Unfortunately
details of the specification make ES6 modules a on a fundamental level
CommonJS modules that are used by Node.js
a nice example). One file has to contain either a
CommonJS module or a
NPM has roughly 300,000 packages. Those packages are written as
(or compiled to)
CommonJS modules. If
ES2015 modules are introduced we
would suddenly be facing packages that are not compatible with
by extension not compatible with node versions that do not support
This means we are left with
This detection would use some string in the file like
"use modules"; to
identify which module system should be used for this file.
(Rejected due to complexity for tooling and implementation as well as due to the constant code tax - this string would need to be in every file)
The type of the module (
ES2015) is detected using the a
special file ending. Several file endings have been discussed, in the end
.mjs has been identified as the best choice.
The content would be pre-parsed to identify whether its a
(Rejected because the detection has ambiguity in
CommonJS packages. This
could be revisited if the TC39 changes the spec, but - for a variety of
other reasons - it is likely to still be rejected)
Patterns written in the
package.json specify whether a file is a
ES2015 module. There have been a few variants of this proposal with
more or less complex specifications.
One property in the
package.json specifies the module type for all files
in the package (sub-packages excluded).
(Note: this is originally variant 4f. Since the implementation consequences are very different it has been named 5.)
.js files would stay
CommonJS modules while the
would need to be implemented in a file called
default.js. Every import
default.js assumes that the referred module is an
Do not implement ES2015 modules.
(Note: this has been rejected by the author because there is lack of evidence that anyone in the community supports to not go with the times. In all likelyness this would split the community and might drive another fork of Node.js.)
CPU cycles and Memory when running node. (5=neglectible, 1=cpu-heavy)
|Extension||5||Only the file-ending has to be tested, no other overhead|
|White-/Blacklist||2||The file-name has to be tested against a potentially complicated list|
|ES2015 switch||4||The first file of a is slower because the
|default.js||4||The first file might be a bit tricky to detect but overall it should be fast.|
Effort it takes to bring this implementation to Node.js. (5=little, 1=much)
|Extension||5||if/else switch, thats it.|
|White-/Blacklist||3||Significantly more difficult than if/else|
|ES2015 switch||1||It requires NPM to implement variants of packages into the package system. However: it is important to mention that the Node.js-side should be rather trivial.|
|default.js||3||It requires a new core API (
Effort to learn the new system. (5=easy, 1=hard)
|Extension||5||File endings can be easily studied.|
|White-/Blacklist||2||Trying to memorize this complex system is hard.|
|ES2015 switch||4||Mostly straight forward, deployment of variants might be a bit harder to learn than if there were only extensions|
|default.js||1||It is not immediately clear why
Increased development difficulty through the proposal. (5=almost-none, 1=a-lot)
|Extension||3||Every developer has to setup his tools to work with the new file extension|
|White-/Blacklist||1||It is not immediately clear which files are
|ES2015 switch||2||The developer has to learn that there are different modes and has to look it up once per package he is working on.|
|default.js||4||Once a developer learned about the
Effort for a developer now to use a
ES2015-only module. (5=little, 1=much)
|Extension||4||If a package decides to switch from
|White-/Blacklist||3||It is not immediately clear which files are
|ES2015 switch||4||Nothing changed but they have to know that old node.js version might not be supported with new packages.|
|default.js||4||Nothing changed (mostly). Since packages default to
Effort a developer has to take to make her package legacy compatible. (5=little, 1=much)
|Extension||3||Always deploy the package with a
|White-/Blacklist||3||The developer has a lot of control over how the packages are built but at the same time she needs to gain control and remember how the system is setup. Human error can easily happen.|
|ES2015 switch||3||The compiler will pretty much work like anywhere else except that it is easier to specify different dependencies for different variants.|
|default.js||4||Legacy packages are straight forward both to deal with and to import.|
Change of a file-size per package. (5=good, 1=bad)
|Extension||1||Has to contain every file twice for legacy packages.|
|White-/Blacklist||1||Has to contain every file twice for legacy packages.|
|ES2015 switch||5||Only the package is downloaded - no change in download-size.|
|default.js||1||Has to contain every file twice for legacy packages.|
Impact that the change has on tools. (5=simple, 1=complicated)
|Extension||4||The .mjs file only needs to be added as file exension.|
|White-/Blacklist||2||By default all editors should mostly work but it seems unlikely that a specification will be consitently adhered-to by all editors.|
|ES2015 switch||5||By default all editors should mostly work. To implement the few edge cases would be simple too.|
|default.js||5||By default all editors should mostly work. To implement the few edge cases would be simple too.|
Node.js can be just called like this:
$ node some.js in any given folder.
The folder does not need to contain a
package.json and as consequence
all of the proposals that rely on the
package.json will not work.
Of the given proposals only a specific file-ending (like
.mjs) can make sure
that modern modules can easily be called from node directly. For the other
proposals you might need something like
$ node --es6 some.js.
As mentioned a lot earlier: This discussion might have been mitigated if the TC39 would be able to fix the parsing incompatibilities in the specification a lot of this discussion would be void.
If interoperability could be accepted then a new possibility would be offered
to us! With a clear way to separate
ES2015 modules from
we could 100% automatically transpile
ES2015 modules to
Since the transpiled version is 100% compatible with the regular version
we could automatically and thus safely provide variants for legacy
versions of Node.js.
5) package variants would need to be implemented in NPM. Once NPM
packages has the infrastructure to support variants, those variants can give
the opporunity to implement other things:
If you have any question feel free to chat on gitter.
And you can join this poll: