JavaScript modules are evaluated asynchronously. However, all imports are evaluated prior to the body of module doing the importing. This makes JavaScript modules different from CommonJS modules in Node or <script>
tags without the async
attribute. JavaScript modules are closer to the AMD spec when it comes to how they are loaded. For more detail, see section 16.6.1 of Exploring ES6 by Axel Rauschmayer.
Thus, in the example provided by the questioner, the order of execution cannot be guaranteed. There are two possible outcomes. We might see this in the console:
one
two
three
Or we might see this:
two
one
three
In other words, the two imported modules could execute their console.log()
calls in any order; they are asynchronous with respect to one another. But they will definitely be executed prior to the body of the module that imports them, so "three"
is guaranteed to be logged last.
The asynchronicity of modules can be observed when using top-level await
statements (now implemented in Chrome). For example, suppose we modify the questioner's example slightly:
// main.js
import './one.js';
import './two.js';
console.log('three');
// one.js
await new Promise(resolve => setTimeout(resolve, 1000));
console.log('one');
// two.js
console.log('two');
When we run main.js
, we see the following in the console (with timestamps added for illustration):
[0s] two
[1s] one
[1s] three
Update as of ES2020
Per petamoriken's answer, it looks like evaluation order is guaranteed for non-async modules as of ES2020. So, if you know none of the modules you're importing contain top-level await
statements, they will be executed in the order in which they are imported. In the case of the questioner's example, the console output will always be:
one
two
three
import
. – Kettledrummer