doc: importable node protocol URLs

PR-URL: #35434 Reviewed-By: Myles Borins <[email protected]> Reviewed-By: Matteo Collina <[email protected]> Reviewed-By: James M Snell <[email protected]> Reviewed-By: Jan Krems <[email protected]>
nodejs · Nov 16, 2020 · 42c0dfc · 42c0dfc
1 parent c192af6
commit 42c0dfc
Showing 1 changed file with 15 additions and 1 deletion.
diff --git a/doc/api/esm.md b/doc/api/esm.md
@@ -125,13 +125,27 @@ There are four types of specifiers:
 Bare specifiers, and the bare specifier portion of deep import specifiers, are
 strings; but everything else in a specifier is a URL.
 
-Only `file:` and `data:` URLs are supported. A specifier like
+`file:`, `node:`, and `data:` URLs are supported. A specifier like
 `'https://example.com/app.js'` may be supported by browsers but it is not
 supported in Node.js.
 
 Specifiers may not begin with `/` or `//`. These are reserved for potential
 future use. The root of the current volume may be referenced via `file:///`.
 
+#### `node:` Imports
+
+<!-- YAML
+added: REPLACEME
+-->
+
+`node:` URLs are supported as a means to load Node.js builtin modules. This
+URL scheme allows for builtin modules to be referenced by valid absolute URL
+strings.
+
+```js
+import fs from 'node:fs/promises';
+```
+
 #### `data:` Imports
 
 <!-- YAML