You cannot use ES6 imports YET.
Which seems to be a little bit weird because you’d guess that it’s probably one of the easiest things to be implemented in a JS engine. But you’d be wrong because supporting this of Node.js is not exactly a walk in the park, considering there are quite a lot of applications out there and they using a different module standard: CommonJS.
And serverside applications are a big part of the JS landscape.
ES6 Modules Versus CommonJS
On the surface, they seem similar, but they are not. There is a fundamental difference between the two: the code in the CommonJS module needs to be executed to see what that module exports, whereas an ES6 module needs only to be parsed (compiled).
whereas ES6 exports look like this:
Ideally, we’d want to be able to write new ES6 code that would run alongside old code, which means we want to be able to import CommonJS modules, as well as require new ES6 modules.
So what a CJS module exports is available only at runtime, NOT at compile time (remember V8 does just-in-time compilation). Also, the existing require() function is synchronous, whereas the ES6 specification states that imports can be async (but DON’T HAVE TO BE, which is good news for Node). Changing the existing implementation for require() would also break a lot of the existing libraries which make assumptions about the way it works. Since the require function is synchronous, module resolution in CJS happens in one event loop tick. With ES6, the module is first parsed and its interface inferred, and ONLY THEN evaluated, so it might take multiple ticks.
This means it won’t be possible to change require() to import ES6 modules. The alternative would be to create a new require.import() function, but this isn’t as nice.
It does however mean that ES6 modules will be able to import CommonJS modules, because they happen in one tick. The tricky part here is figuring if a module is ES6 or CommonJS.
Browsers know that a module is ES6 or not like this:
<script type="module" src="./es6module.js"></script>
However Node.js doesn’t have that luxury. The solution the community agreed upon was using .mjs files to denote ES6 modules, also affectionately named the Michael Jackson Solution.
While this is work in progress, so far it’s fair to assume that:
- The require() function won’t be available in ES6 module files.
- import won’t be available to CommonJS modules.
- ES6 modules will be able to import CJS modules, as well as other ES6 modules (obviously).
- CJS modules will be able to require.import() ES6 modules, as well as other CJS modules using require() like before.
Also, there is an issue with named imports when importing a CommonJS module. The difference again has to do with with the fact the public interface of an ES6 module can be determined at compile time, whereas CommonJS modules actually have to be executed.
Which means for a CJS module that looks like this:
The importing code would look like:
Keep in mind that defaultImport will not be ‘some_text’ because import doesn’t evaluate the code. It would actually be an object containing all the objects declared which would look like this in our case:
Floating is a typical way of
Also, we are probably looking at beginning 2018 before any of this functionality is available.