diff --git a/README.md b/README.md index 3387975cca122c..1630cc05eb334c 100644 --- a/README.md +++ b/README.md @@ -283,8 +283,6 @@ For information about the governance of the Node.js project, see **David Carlier** <devnexen@gmail.com> * [devsnek](https://github.com/devsnek) - **Gus Caplan** <me@gus.host> (he/him) -* [digitalinfinity](https://github.com/digitalinfinity) - -**Hitesh Kanwathirtha** <digitalinfinity@gmail.com> (he/him) * [edsadr](https://github.com/edsadr) - **Adrian Estrada** <edsadr@gmail.com> (he/him) * [eugeneo](https://github.com/eugeneo) - @@ -307,8 +305,6 @@ For information about the governance of the Node.js project, see **Jiawen Geng** <technicalcute@gmail.com> * [GeoffreyBooth](https://github.com/geoffreybooth) - **Geoffrey Booth** <webmaster@geoffreybooth.com> (he/him) -* [gibfahn](https://github.com/gibfahn) - -**Gibson Fahnestock** <gibfahn@gmail.com> (he/him) * [gireeshpunathil](https://github.com/gireeshpunathil) - **Gireesh Punathil** <gpunathi@in.ibm.com> (he/him) * [guybedford](https://github.com/guybedford) - @@ -454,12 +450,16 @@ For information about the governance of the Node.js project, see **Claudio Rodriguez** <cjrodr@yahoo.com> * [DavidCai1993](https://github.com/DavidCai1993) - **David Cai** <davidcai1993@yahoo.com> (he/him) +* [digitalinfinity](https://github.com/digitalinfinity) - +**Hitesh Kanwathirtha** <digitalinfinity@gmail.com> (he/him) * [eljefedelrodeodeljefe](https://github.com/eljefedelrodeodeljefe) - **Robert Jefe Lindstaedt** <robert.lindstaedt@gmail.com> * [estliberitas](https://github.com/estliberitas) - **Alexander Makarenko** <estliberitas@gmail.com> * [firedfox](https://github.com/firedfox) - **Daniel Wang** <wangyang0123@gmail.com> +* [gibfahn](https://github.com/gibfahn) - +**Gibson Fahnestock** <gibfahn@gmail.com> (he/him) * [glentiki](https://github.com/glentiki) - **Glen Keane** <glenkeane.94@gmail.com> (he/him) * [iarna](https://github.com/iarna) - diff --git a/doc/api/cli.md b/doc/api/cli.md index c01edf1a1a1e8a..e546473ba3885e 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -1579,5 +1579,5 @@ $ node --max-old-space-size=1536 index.js [emit_warning]: process.html#process_process_emitwarning_warning_type_code_ctor [experimental ECMAScript Module loader]: esm.html#esm_experimental_loaders [jitless]: https://v8.dev/blog/jitless -[libuv threadpool documentation]: http://docs.libuv.org/en/latest/threadpool.html +[libuv threadpool documentation]: https://docs.libuv.org/en/latest/threadpool.html [remote code execution]: https://www.owasp.org/index.php/Code_Injection diff --git a/doc/api/dns.md b/doc/api/dns.md index 20554fdc1d75d3..73f3d80254ac2f 100644 --- a/doc/api/dns.md +++ b/doc/api/dns.md @@ -618,7 +618,7 @@ The [`dns.setServers()`][] method affects only [`dns.resolve()`][], [`dns.lookup()`][]). This method works much like -[resolve.conf](http://man7.org/linux/man-pages/man5/resolv.conf.5.html). +[resolve.conf](https://man7.org/linux/man-pages/man5/resolv.conf.5.html). That is, if attempting to resolve with the first server provided results in a `NOTFOUND` error, the `resolve()` method will *not* attempt to resolve with subsequent servers provided. Fallback DNS servers will only be used if the @@ -1082,7 +1082,7 @@ The `dnsPromises.setServers()` method must not be called while a DNS query is in progress. This method works much like -[resolve.conf](http://man7.org/linux/man-pages/man5/resolv.conf.5.html). +[resolve.conf](https://man7.org/linux/man-pages/man5/resolv.conf.5.html). That is, if attempting to resolve with the first server provided results in a `NOTFOUND` error, the `resolve()` method will *not* attempt to resolve with subsequent servers provided. Fallback DNS servers will only be used if the diff --git a/doc/api/errors.md b/doc/api/errors.md index 15428b8a148a62..92715e1236bb96 100644 --- a/doc/api/errors.md +++ b/doc/api/errors.md @@ -919,6 +919,15 @@ for the JS engine are not set up properly. A `Promise` that was callbackified via `util.callbackify()` was rejected with a falsy value. + +#### `ERR_FEATURE_UNAVAILABLE_ON_PLATFORM` + + +Used when a feature that is not available +to the current platform which is running Node.js is used. + ### `ERR_FS_FILE_TOO_LARGE` @@ -2622,84 +2631,6 @@ removed: v10.0.0 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_ENTRY_TYPE_MISMATCH` - -The `--entry-type=commonjs` flag was used to attempt to execute an `.mjs` file -or a `.js` file where the nearest parent `package.json` contains -`"type": "module"`; or -the `--entry-type=module` flag was used to attempt to execute a `.cjs` file or -a `.js` file where the nearest parent `package.json` either lacks a `"type"` -field or contains `"type": "commonjs"`. - - -#### `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_INVALID_REPL_TYPE` - -The `--entry-type=...` flag is not compatible with the Node.js REPL. - - -#### `ERR_FEATURE_UNAVAILABLE_ON_PLATFORM` - -Used when a feature that is not available -to the current platform which is running Node.js is used. - - -#### `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. - - -#### `ERR_TTY_WRITABLE_NOT_READABLE` - -This `Error` is thrown when a read is attempted on a TTY `WriteStream`, -such as `process.stdout.on('data')`. - [`'uncaughtException'`]: process.html#process_event_uncaughtexception [`--disable-proto=throw`]: cli.html#cli_disable_proto_mode [`--force-fips`]: cli.html#cli_force_fips @@ -2723,7 +2654,7 @@ such as `process.stdout.on('data')`. [`dgram.createSocket()`]: dgram.html#dgram_dgram_createsocket_options_callback [`dgram.disconnect()`]: dgram.html#dgram_socket_disconnect [`dgram.remoteAddress()`]: dgram.html#dgram_socket_remoteaddress -[`errno`(3) man page]: http://man7.org/linux/man-pages/man3/errno.3.html +[`errno`(3) man page]: https://man7.org/linux/man-pages/man3/errno.3.html [`fs.Dir`]: fs.html#fs_class_fs_dir [`fs.readFileSync`]: fs.html#fs_fs_readfilesync_path_options [`fs.readdir`]: fs.html#fs_fs_readdir_path_options_callback @@ -2735,7 +2666,7 @@ such as `process.stdout.on('data')`. [`hash.update()`]: crypto.html#crypto_hash_update_data_inputencoding [`http`]: http.html [`https`]: https.html -[`libuv Error handling`]: http://docs.libuv.org/en/v1.x/errors.html +[`libuv Error handling`]: https://docs.libuv.org/en/v1.x/errors.html [`net`]: net.html [`new URL(input)`]: url.html#url_new_url_input_base [`new URLSearchParams(iterable)`]: url.html#url_new_urlsearchparams_iterable @@ -2771,7 +2702,7 @@ such as `process.stdout.on('data')`. [policy]: policy.html [RFC 7230 Section 3]: https://tools.ietf.org/html/rfc7230#section-3 [stream-based]: stream.html -[syscall]: http://man7.org/linux/man-pages/man2/syscalls.2.html +[syscall]: https://man7.org/linux/man-pages/man2/syscalls.2.html [Subresource Integrity specification]: https://www.w3.org/TR/SRI/#the-integrity-attribute [try-catch]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch [vm]: vm.html diff --git a/doc/api/esm.md b/doc/api/esm.md index c06ba4782af884..75a7c07ddbcbe3 100644 --- a/doc/api/esm.md +++ b/doc/api/esm.md @@ -1817,11 +1817,11 @@ success! [`module.createRequire()`]: modules.html#modules_module_createrequire_filename [`module.syncBuiltinESMExports()`]: modules.html#modules_module_syncbuiltinesmexports [`transformSource` hook]: #esm_code_transformsource_code_hook -[ArrayBuffer]: http://www.ecma-international.org/ecma-262/6.0/#sec-arraybuffer-constructor +[ArrayBuffer]: https://www.ecma-international.org/ecma-262/6.0/#sec-arraybuffer-constructor [SharedArrayBuffer]: https://tc39.es/ecma262/#sec-sharedarraybuffer-constructor -[string]: http://www.ecma-international.org/ecma-262/6.0/#sec-string-constructor -[TypedArray]: http://www.ecma-international.org/ecma-262/6.0/#sec-typedarray-objects -[Uint8Array]: http://www.ecma-international.org/ecma-262/6.0/#sec-uint8array +[string]: https://www.ecma-international.org/ecma-262/6.0/#sec-string-constructor +[TypedArray]: https://www.ecma-international.org/ecma-262/6.0/#sec-typedarray-objects +[Uint8Array]: https://www.ecma-international.org/ecma-262/6.0/#sec-uint8array [`util.TextDecoder`]: util.html#util_class_util_textdecoder [import an ES or CommonJS module for its side effects only]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#Import_a_module_for_its_side_effects_only [special scheme]: https://url.spec.whatwg.org/#special-scheme diff --git a/doc/api/fs.md b/doc/api/fs.md index 9969412dbdb48f..d9d36b6e1024ea 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -654,8 +654,8 @@ added: v0.1.93 * Extends: {stream.Readable} -A successful call to `fs.createReadStream()` will return a new `fs.ReadStream` -object. +Instances of `fs.ReadStream` are created and returned using the +[`fs.createReadStream()`][] function. ### Event: `'close'` - -* `jsonChunk` {string} A JSON fragment. - -Emitted if the `qlog: true` option was passed to `quicsocket.connect()` or -`net.createQuicSocket()` functions. - -The argument is a JSON fragment according to the [qlog standard][]. - -The `'qlog'` event will be emitted multiple times. - #### Event: `'secure'` + +* Type: {stream.Readable} + +If `qlog` support is enabled for `QuicSession`, the `quicsession.qlog` property +provides a [`stream.Readable`][] that may be used to access the `qlog` event +data according to the [qlog standard][]. For client `QuicSessions`, the +`quicsession.qlog` property will be `undefined` untilt the `'qlog'` event +is emitted. + #### quicsession.remoteAddress + +The `'qlog'` event is emitted when the `QuicClientSession` is ready to begin +providing `qlog` event data. The callback is invoked with a single argument: + +* `qlog` {stream.Readable} A [`stream.Readable`][] that is also available using + the `quicsession.qlog` property. + #### Event: `'usePreferredAddress'`