From 35d6b4cdaf27c4425fd75e96b020b6cdc5675ba2 Mon Sep 17 00:00:00 2001 From: Sarat Addepalli Date: Thu, 2 Aug 2018 12:28:19 +0530 Subject: [PATCH] doc: document removed error codes PR-URL: https://github.com/nodejs/node/pull/22100 Fixes: https://github.com/nodejs/node/issues/22061 Refs: https://github.com/nodejs/node/pull/21491 Reviewed-By: Vse Mozhet Byt Reviewed-By: Joyee Cheung --- doc/api/errors.md | 199 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 199 insertions(+) diff --git a/doc/api/errors.md b/doc/api/errors.md index 036754afc132e9..7e6f7cc3406a50 100644 --- a/doc/api/errors.md +++ b/doc/api/errors.md @@ -1842,6 +1842,204 @@ Creation of a [`zlib`][] object failed due to incorrect configuration. A module file could not be resolved while attempting a [`require()`][] or `import` operation. +## Legacy Node.js Error Codes + +> Stability: 0 - Deprecated. These error codes are either inconsistent, or have +> been removed. + + +### ERR_HTTP2_FRAME_ERROR + + +Used when a failure occurs sending an individual frame on the HTTP/2 +session. + + +### ERR_HTTP2_HEADERS_OBJECT + + +Used when an HTTP/2 Headers Object is expected. + + +### ERR_HTTP2_HEADER_REQUIRED + + +Used when a required header is missing in an HTTP/2 message. + + +### ERR_HTTP2_INFO_HEADERS_AFTER_RESPOND + + +HTTP/2 informational headers must only be sent *prior* to calling the +`Http2Stream.prototype.respond()` method. + + +### ERR_HTTP2_STREAM_CLOSED + + +Used when an action has been performed on an HTTP/2 Stream that has already +been closed. + + +### ERR_HTTP_INVALID_CHAR + + +Used when an invalid character is found in an HTTP response status message +(reason phrase). + + +### ERR_NAPI_CONS_PROTOTYPE_OBJECT + + +Used by the `N-API` when `Constructor.prototype` is not an object. + + +### ERR_OUTOFMEMORY + + +Used generically to identify that an operation caused an out of memory +condition. + + +### ERR_PARSE_HISTORY_DATA + + +The `repl` module was unable to parse data from the REPL history file. + + +### ERR_STREAM_READ_NOT_IMPLEMENTED + + +Used when an attempt is made to use a readable stream that has not implemented +[`readable._read()`][]. + + +### ERR_TLS_RENEGOTIATION_FAILED + + +Used when a TLS renegotiation request has failed in a non-specific way. + + +### ERR_UNKNOWN_BUILTIN_MODULE + + +The `'ERR_UNKNOWN_BUILTIN_MODULE'` error code is used to identify a specific +kind of internal Node.js error that should not typically be triggered by user +code. Instances of this error point to an internal bug within the Node.js +binary itself. + + +### ERR_VALUE_OUT_OF_RANGE + + +Used when a given value is out of the accepted range. + + +### ERR_ZLIB_BINDING_CLOSED + + +Used when an attempt is made to use a `zlib` object after it has already been +closed. + +### Other error codes + +These errors have never been released, but had been present on master between +releases. + + +#### ERR_FS_WATCHER_ALREADY_STARTED + +An attempt was made to start a watcher returned by `fs.watch()` that has +already been started. + + +#### ERR_FS_WATCHER_NOT_STARTED + +An attempt was made to initiate operations on a watcher returned by +`fs.watch()` that has not yet been started. + + +#### ERR_HTTP2_ALREADY_SHUTDOWN + +Occurs with multiple attempts to shutdown an HTTP/2 session. + + +#### ERR_HTTP2_ERROR + +A non-specific HTTP/2 error has occurred. + + +#### ERR_INVALID_REPL_HISTORY + +Used in the `repl` in case the old history file is used and an error occurred +while trying to read and parse it. + + +#### ERR_MISSING_DYNAMIC_INSTANTIATE_HOOK + +Used when an [ES6 module][] loader hook specifies `format: 'dynamic'` but does +not provide a `dynamicInstantiate` hook. + + +#### ERR_STREAM_HAS_STRINGDECODER + +Used to prevent an abort if a string decoder was set on the Socket. + +```js +const Socket = require('net').Socket; +const instance = new Socket(); + +instance.setEncoding('utf8'); +``` + + +#### ERR_STRING_TOO_LARGE + +An attempt has been made to create a string larger than the maximum allowed +size. + [`--force-fips`]: cli.html#cli_force_fips [`'uncaughtException'`]: process.html#process_event_uncaughtexception [`child_process`]: child_process.html @@ -1869,6 +2067,7 @@ A module file could not be resolved while attempting a [`require()`][] or [`new URLSearchParams(iterable)`]: url.html#url_constructor_new_urlsearchparams_iterable [`process.send()`]: process.html#process_process_send_message_sendhandle_options_callback [`process.setUncaughtExceptionCaptureCallback()`]: process.html#process_process_setuncaughtexceptioncapturecallback_fn +[`readable._read()`]: stream.html#stream_readable_read_size_1 [`require()`]: modules.html#modules_require [`require('crypto').setEngine()`]: crypto.html#crypto_crypto_setengine_engine_flags [`server.listen()`]: net.html#net_server_listen