summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGuy Bedford <guybedford@gmail.com>2020-10-23 11:50:44 -0700
committerRichard Lau <rlau@redhat.com>2021-03-17 21:14:18 +0000
commitbf8733fe22d47ce2d54a1516cf87a03fba582ea2 (patch)
tree282145bc4d5890a9965ccb0f5021cdd8a1272796
parentf5692093d3aab880afd2fe8c994ebdec0dedcae6 (diff)
downloadnode-new-bf8733fe22d47ce2d54a1516cf87a03fba582ea2.tar.gz
doc: mark modules implementation as stable
PR-URL: https://github.com/nodejs/node/pull/35781 Backport-PR-URL: https://github.com/nodejs/node/pull/37718 Reviewed-By: Matteo Collina <matteo.collina@gmail.com> Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Rich Trott <rtrott@gmail.com> Reviewed-By: Michaƫl Zasso <targos@protonmail.com> Reviewed-By: Franziska Hinkelmann <franziska.hinkelmann@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Myles Borins <myles.borins@gmail.com> Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com> Reviewed-By: Derek Lewis <DerekNonGeneric@inf.is>
-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 f776f45814..938aec7d44 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:
- v12.20.0
pr-url: https://github.com/nodejs/node/pull/35249
description: Support for detection of CommonJS named exports.
@@ -23,7 +27,7 @@ changes:
`"type"` field.
-->
-> Stability: 1 - Experimental
+> Stability: 2 - Stable
## Introduction
@@ -55,15 +59,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>
@@ -1268,9 +1266,7 @@ success!
[CommonJS]: modules.html
[Conditional exports]: packages.html#packages_conditional_exports
[Dynamic `import()`]: https://wiki.developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#Dynamic_Imports
-[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
[Terminology]: #esm_terminology
[WHATWG JSON modules specification]: https://html.spec.whatwg.org/#creating-a-json-module-script
[`data:` URLs]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs