diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md index 88f051904f8b7c..62a3795407d8c9 100644 --- a/doc/api/deprecations.md +++ b/doc/api/deprecations.md @@ -3918,6 +3918,20 @@ Type: Runtime The `node:_tls_common` and `node:_tls_wrap` modules are deprecated as they should be considered an internal nodejs implementation rather than a public facing API, use `node:tls` instead. +### DEP0193: `util.types.isNativeError()` + + + +Type: Documentation-only + +The [`util.types.isNativeError`][] API is deprecated. Please use [`Error.isError`][] instead. + [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 @@ -3935,6 +3949,7 @@ an internal nodejs implementation rather than a public facing API, use `node:tls [`Buffer.isBuffer()`]: buffer.md#static-method-bufferisbufferobj [`Cipheriv`]: crypto.md#class-cipheriv [`Decipheriv`]: crypto.md#class-decipheriv +[`Error.isError`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/isError [`REPLServer.clearBufferedCommand()`]: repl.md#replserverclearbufferedcommand [`ReadStream.open()`]: fs.md#class-fsreadstream [`Server.getConnections()`]: net.md#servergetconnectionscallback @@ -4046,6 +4061,7 @@ an internal nodejs implementation rather than a public facing API, use `node:tls [`util.isArray()`]: util.md#utilisarrayobject [`util.promisify`]: util.md#utilpromisifyoriginal [`util.toUSVString()`]: util.md#utiltousvstringstring +[`util.types.isNativeError`]: util.md#utiltypesisnativeerrorvalue [`util.types`]: util.md#utiltypes [`util`]: util.md [`worker.exitedAfterDisconnect`]: cluster.md#workerexitedafterdisconnect diff --git a/doc/api/util.md b/doc/api/util.md index 413b05cb5d9694..657abc6ff0649a 100644 --- a/doc/api/util.md +++ b/doc/api/util.md @@ -3319,8 +3319,14 @@ util.types.isModuleNamespaceObject(ns); // Returns true +> Stability: 0 - Deprecated: Use [`Error.isError`][] instead. + +**Note:** As of Node.js v24, `Error.isError()` is currently slower than `util.types.isNativeError()`. +If performance is critical, consider benchmarking both in your environment. + * `value` {any} * Returns: {boolean} @@ -3707,6 +3713,7 @@ util.isArray({}); [`'warning'`]: process.md#event-warning [`Array.isArray()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray [`ArrayBuffer.isView()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/isView +[`Error.isError`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/isError [`JSON.stringify()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify [`MIMEparams`]: #class-utilmimeparams [`Object.assign()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/assign