summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGuy Bedford <guybedford@gmail.com>2020-10-23 11:50:44 -0700
committerMyles Borins <mylesborins@github.com>2020-11-18 15:28:43 -0500
commitb4758fffa1d7af5ace6ca06c416062b72af962be (patch)
tree52b71f4e721073138284747290e72a0f20065164
parentb3b0c4347426094afe48c9e2562881e3e2b0c186 (diff)
downloadnode-new-stabilize-modules.tar.gz
doc: mark modules implementation as stablestabilize-modules
-rw-r--r--doc/api/esm.md16
1 files changed, 6 insertions, 10 deletions
diff --git a/doc/api/esm.md b/doc/api/esm.md
index e631f6c392..385aee6f84 100644
--- a/doc/api/esm.md
+++ b/doc/api/esm.md
@@ -6,6 +6,10 @@
added: v8.5.0
changes:
- version:
+ - REPLACEME
+ pr-url: https://github.com/nodejs/node/pull/35781
+ description: Stabilize modules implementation.
+ - version:
- v14.13.0
pr-url: https://github.com/nodejs/node/pull/35249
description: Support for detection of CommonJS named exports.
@@ -29,7 +33,7 @@ changes:
`"type"` field.
-->
-> Stability: 1 - Experimental
+> Stability: 2 - Stable
## Introduction
@@ -61,15 +65,9 @@ console.log(addTwo(4));
```
Node.js fully supports ECMAScript modules as they are currently specified and
-provides limited interoperability between them and the existing module format,
+provides interoperability between them and its original module format,
[CommonJS][].
-Node.js contains support for ES Modules based upon the
-[Node.js EP for ES Modules][] and the [ECMAScript-modules implementation][].
-
-Expect major changes in the implementation including interoperability support,
-specifier resolution, and default behavior.
-
<!-- Anchors to make sure old links find a target -->
<i id="esm_package_json_type_field"></i>
<i id="esm_package_scope_and_file_extensions"></i>
@@ -1300,9 +1298,7 @@ success!
[Core modules]: modules.md#modules_core_modules
[Dynamic `import()`]: https://wiki.developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#Dynamic_Imports
[ECMAScript Top-Level `await` proposal]: https://github.com/tc39/proposal-top-level-await/
-[ECMAScript-modules implementation]: https://github.com/nodejs/modules/blob/master/doc/plan-for-new-modules-implementation.md
[ES Module Integration Proposal for Web Assembly]: https://github.com/webassembly/esm-integration
-[Node.js EP for ES Modules]: https://github.com/nodejs/node-eps/blob/master/002-es-modules.md
[Node.js Module Resolution Algorithm]: #esm_resolver_algorithm_specification
[Terminology]: #esm_terminology
[URL]: https://url.spec.whatwg.org/