nodejs
diff --git a/Collapse file
‎doc/api/deprecations.md‎
Copy file name to clipboardExpand all lines: doc/api/deprecations.md
+25Lines changed: 25 additions & 0 deletions
Display the source diff
Display the rich diff b/Collapse file
‎doc/api/deprecations.md‎
Copy file name to clipboardExpand all lines: doc/api/deprecations.md
+25Lines changed: 25 additions & 0 deletions
Display the source diff
Display the rich diff
diff --git a/Collapse file
‎doc/api/module.md‎
Copy file name to clipboardExpand all lines: doc/api/module.md
+2-1Lines changed: 2 additions & 1 deletion
Display the source diff
Display the rich diff b/Collapse file
‎doc/api/module.md‎
Copy file name to clipboardExpand all lines: doc/api/module.md
+2-1Lines changed: 2 additions & 1 deletion
Display the source diff
Display the rich diff
diff --git a/Collapse file
‎test/doctool/test-doc-api-json.mjs‎
Copy file name to clipboardExpand all lines: test/doctool/test-doc-api-json.mjs
+1-1Lines changed: 1 addition & 1 deletion b/Collapse file
‎test/doctool/test-doc-api-json.mjs‎
Copy file name to clipboardExpand all lines: test/doctool/test-doc-api-json.mjs
+1-1Lines changed: 1 addition & 1 deletion
@@ -4497,6 +4497,28 @@ Type: Documentation-only
 Passing a non-extractable [`CryptoKey`][] to [`KeyObject.from()`][] is
 deprecated and will throw an error in a future version.
 
+### DEP0205: `module.register()`
+
+<!-- YAML
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/62395
+    description: Documentation-only deprecation.
+-->
+
+Type: Documentation-only
+
+[`module.register()`][] is deprecated. Use [`module.registerHooks()`][]
+instead.
+
+The `module.register()` API provides off-thread async hooks for customizing ES modules;
+the `module.registerHooks()` API provides similar hooks that are synchronous, in-thread, and
+work for all types of modules.
+Supporting async hooks has proven to be complex, involving worker threads orchestration, and there are issues
+that have proven unresolveable. See [caveats of asynchronous customization hooks][]. Please migrate to
+`module.registerHooks()` as soon as possible as `module.register()` will be
+removed in a future version of Node.js.
+
 [DEP0142]: #dep0142-repl_builtinlibs
 [NIST SP 800-38D]: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf
 [RFC 6066]: https://tools.ietf.org/html/rfc6066#section-3
@@ -4601,6 +4623,8 @@ deprecated and will throw an error in a future version.
 [`message.trailersDistinct`]: http.md#messagetrailersdistinct
 [`message.trailers`]: http.md#messagetrailers
 [`module.createRequire()`]: module.md#modulecreaterequirefilename
+[`module.register()`]: module.md#moduleregisterspecifier-parenturl-options
+[`module.registerHooks()`]: module.md#moduleregisterhooksoptions
 [`os.networkInterfaces()`]: os.md#osnetworkinterfaces
 [`os.tmpdir()`]: os.md#ostmpdir
 [`process.env`]: process.md#processenv
@@ -4654,6 +4678,7 @@ deprecated and will throw an error in a future version.
 [`zlib.bytesWritten`]: zlib.md#zlibbyteswritten
 [alloc]: buffer.md#static-method-bufferallocsize-fill-encoding
 [alloc_unsafe_size]: buffer.md#static-method-bufferallocunsafesize
+[caveats of asynchronous customization hooks]: module.md#caveats-of-asynchronous-customization-hooks
 [from_arraybuffer]: buffer.md#static-method-bufferfromarraybuffer-byteoffset-length
 [from_string_encoding]: buffer.md#static-method-bufferfromstring-encoding
 [legacy URL API]: url.md#legacy-url-api
 
@@ -178,6 +178,7 @@ isBuiltin('wss'); // false
 added:
   - v20.6.0
   - v18.19.0
+deprecated: REPLACEME
 changes:
   - version:
     - v23.6.1
@@ -193,7 +194,7 @@ changes:
     description: Add support for WHATWG URL instances.
 -->
 
-> Stability: 1.1 - Active development
+> Stability: 0 - Deprecated: Use [`module.registerHooks()`][] instead.
 
 * `specifier` {string|URL} Customization hooks to be registered; this should be
   the same string that would be passed to `import()`, except that if it is
 
@@ -160,5 +160,5 @@ for await (const dirent of await fs.opendir(new URL('../../out/doc/api/', import
   assert.partialDeepStrictEqual(allExpectedKeys, findAllKeys(json));
 }
 
-assert.strictEqual(numberOfDeprecatedSections, 44); // Increase this number every time a new API is deprecated.
+assert.strictEqual(numberOfDeprecatedSections, 45); // Increase this number every time a new API is deprecated.
 assert.strictEqual(numberOfRemovedAPIs, 46); // Increase this number every time a section is marked as removed.
Original file line number	Diff line number	Diff line change
`@@ -160,5 +160,5 @@ for await (const dirent of await fs.opendir(new URL('../../out/doc/api/', import`
`160`	`160`	`assert.partialDeepStrictEqual(allExpectedKeys, findAllKeys(json));`
`161`	`161`	`}`
`162`	`162`
`163`		`-assert.strictEqual(numberOfDeprecatedSections, 44); // Increase this number every time a new API is deprecated.`
	`163`	`+assert.strictEqual(numberOfDeprecatedSections, 45); // Increase this number every time a new API is deprecated.`
`164`	`164`	`assert.strictEqual(numberOfRemovedAPIs, 46); // Increase this number every time a section is marked as removed.`