Commit 3406910
doc: clarify escaping for ES modules
This should make it clear(er) how to escape special characters like `#`
and `?`.
Ref: #41052
PR-URL: #41074
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>1 parent 1f6a9c3 commit 3406910
1 file changed
Lines changed: 3 additions & 2 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -154,8 +154,8 @@ typically configured server. | |||
| 154 | 154 | ||
| 155 | 155 | ### URLs | |
| 156 | 156 | ||
| 157 | - ES modules are resolved and cached as URLs. This means that files containing | ||
| 158 | - special characters such as `#` and `?` need to be escaped. | ||
| 157 | + ES modules are resolved and cached as URLs. This means that special characters | ||
| 158 | + must be [percent-encoded][], such as `#` with `%23` and `?` with `%3F`. | ||
| 159 | 159 | ||
| 160 | 160 | `file:`, `node:`, and `data:` URL schemes are supported. A specifier like | |
| 161 | 161 | `'https://example.com/app.js'` is not supported natively in Node.js unless using | |
@@ -1457,6 +1457,7 @@ success! | |||
| 1457 | 1457 | [cjs-module-lexer]: https://github.com/nodejs/cjs-module-lexer/tree/1.2.2 | |
| 1458 | 1458 | [custom https loader]: #https-loader | |
| 1459 | 1459 | [load hook]: #loadurl-context-defaultload | |
| 1460 | + [percent-encoded]: url.md#percent-encoding-in-urls | ||
| 1460 | 1461 | [resolve hook]: #resolvespecifier-context-defaultresolve | |
| 1461 | 1462 | [special scheme]: https://url.spec.whatwg.org/#special-scheme | |
| 1462 | 1463 | [the official standard format]: https://tc39.github.io/ecma262/#sec-modules | |
0 commit comments