@types/node 20.12.7 → 20.12.9

node/http2.d.ts

@@ -6,7 +6,7 @@
  * const http2 = require('node:http2');
  * ```
  * @since v8.4.0
- * @see [source](https://github.com/nodejs/node/blob/v20.2.0/lib/http2.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.12.2/lib/http2.js)
  */
 declare module "http2" {
     import EventEmitter = require("node:events");
@@ -96,7 +96,7 @@ declare module "http2" {
          */
         readonly endAfterHeaders: boolean;
         /**
-         * The numeric stream identifier of this `Http2Stream` instance. Set to `undefined`if the stream identifier has not yet been assigned.
+         * The numeric stream identifier of this `Http2Stream` instance. Set to `undefined` if the stream identifier has not yet been assigned.
          * @since v8.4.0
          */
         readonly id?: number | undefined;
@@ -109,7 +109,7 @@ declare module "http2" {
         /**
          * Set to the `RST_STREAM` `error code` reported when the `Http2Stream` is
          * destroyed after either receiving an `RST_STREAM` frame from the connected peer,
-         * calling `http2stream.close()`, or `http2stream.destroy()`. Will be`undefined` if the `Http2Stream` has not been closed.
+         * calling `http2stream.close()`, or `http2stream.destroy()`. Will be `undefined` if the `Http2Stream` has not been closed.
          * @since v8.4.0
          */
         readonly rstCode: number;
@@ -136,7 +136,7 @@ declare module "http2" {
          */
         readonly session: Http2Session | undefined;
         /**
-         * Provides miscellaneous information about the current state of the`Http2Stream`.
+         * Provides miscellaneous information about the current state of the `Http2Stream`.
          *
          * A current state of this `Http2Stream`.
          * @since v8.4.0
@@ -355,7 +355,7 @@ declare module "http2" {
         /**
          * Read-only property mapped to the `SETTINGS_ENABLE_PUSH` flag of the remote
          * client's most recent `SETTINGS` frame. Will be `true` if the remote peer
-         * accepts push streams, `false` otherwise. Settings are the same for every`Http2Stream` in the same `Http2Session`.
+         * accepts push streams, `false` otherwise. Settings are the same for every `Http2Stream` in the same `Http2Session`.
          * @since v8.4.0
          */
         readonly pushAllowed: boolean;
@@ -365,7 +365,7 @@ declare module "http2" {
          */
         additionalHeaders(headers: OutgoingHttpHeaders): void;
         /**
-         * Initiates a push stream. The callback is invoked with the new `Http2Stream`instance created for the push stream passed as the second argument, or an`Error` passed as the first argument.
+         * Initiates a push stream. The callback is invoked with the new `Http2Stream` instance created for the push stream passed as the second argument, or an `Error` passed as the first argument.
          *
          * ```js
          * const http2 = require('node:http2');
@@ -382,7 +382,7 @@ declare module "http2" {
          * ```
          *
          * Setting the weight of a push stream is not allowed in the `HEADERS` frame. Pass
-         * a `weight` value to `http2stream.priority` with the `silent` option set to`true` to enable server-side bandwidth balancing between concurrent streams.
+         * a `weight` value to `http2stream.priority` with the `silent` option set to `true` to enable server-side bandwidth balancing between concurrent streams.
          *
          * Calling `http2stream.pushStream()` from within a pushed stream is not permitted
          * and will throw an error.
@@ -413,7 +413,7 @@ declare module "http2" {
          * used to sent trailing header fields to the peer.
          *
          * When `options.waitForTrailers` is set, the `Http2Stream` will not automatically
-         * close when the final `DATA` frame is transmitted. User code must call either`http2stream.sendTrailers()` or `http2stream.close()` to close the`Http2Stream`.
+         * close when the final `DATA` frame is transmitted. User code must call either `http2stream.sendTrailers()` or `http2stream.close()` to close the `Http2Stream`.
          *
          * ```js
          * const http2 = require('node:http2');
@@ -459,7 +459,7 @@ declare module "http2" {
          *
          * The optional `options.statCheck` function may be specified to give user code
          * an opportunity to set additional content headers based on the `fs.Stat` details
-         * of the given fd. If the `statCheck` function is provided, the`http2stream.respondWithFD()` method will perform an `fs.fstat()` call to
+         * of the given fd. If the `statCheck` function is provided, the `http2stream.respondWithFD()` method will perform an `fs.fstat()` call to
          * collect details on the provided file descriptor.
          *
          * The `offset` and `length` options may be used to limit the response to a
@@ -478,7 +478,7 @@ declare module "http2" {
          * header fields to the peer.
          *
          * When `options.waitForTrailers` is set, the `Http2Stream` will not automatically
-         * close when the final `DATA` frame is transmitted. User code _must_ call either`http2stream.sendTrailers()` or `http2stream.close()` to close the`Http2Stream`.
+         * close when the final `DATA` frame is transmitted. User code _must_ call either `http2stream.sendTrailers()` or `http2stream.close()` to close the `Http2Stream`.
          *
          * ```js
          * const http2 = require('node:http2');
@@ -521,7 +521,7 @@ declare module "http2" {
          * an opportunity to set additional content headers based on the `fs.Stat` details
          * of the given file:
          *
-         * If an error occurs while attempting to read the file data, the `Http2Stream`will be closed using an `RST_STREAM` frame using the standard `INTERNAL_ERROR`code. If the `onError` callback is
+         * If an error occurs while attempting to read the file data, the `Http2Stream` will be closed using an `RST_STREAM` frame using the standard `INTERNAL_ERROR` code. If the `onError` callback is
          * defined, then it will be called. Otherwise
          * the stream will be destroyed.
          *
@@ -559,7 +559,7 @@ declare module "http2" {
          *
          * The `options.statCheck` function may also be used to cancel the send operation
          * by returning `false`. For instance, a conditional request may check the stat
-         * results to determine if the file has been modified to return an appropriate`304` response:
+         * results to determine if the file has been modified to return an appropriate `304` response:
          *
          * ```js
          * const http2 = require('node:http2');
@@ -647,18 +647,18 @@ declare module "http2" {
         /**
          * Value will be `undefined` if the `Http2Session` is not yet connected to a
          * socket, `h2c` if the `Http2Session` is not connected to a `TLSSocket`, or
-         * will return the value of the connected `TLSSocket`'s own `alpnProtocol`property.
+         * will return the value of the connected `TLSSocket`'s own `alpnProtocol` property.
          * @since v9.4.0
          */
         readonly alpnProtocol?: string | undefined;
         /**
-         * Will be `true` if this `Http2Session` instance has been closed, otherwise`false`.
+         * Will be `true` if this `Http2Session` instance has been closed, otherwise `false`.
          * @since v9.4.0
          */
         readonly closed: boolean;
         /**
          * Will be `true` if this `Http2Session` instance is still connecting, will be set
-         * to `false` before emitting `connect` event and/or calling the `http2.connect`callback.
+         * to `false` before emitting `connect` event and/or calling the `http2.connect` callback.
          * @since v10.0.0
          */
         readonly connecting: boolean;
@@ -677,7 +677,7 @@ declare module "http2" {
          */
         readonly encrypted?: boolean | undefined;
         /**
-         * A prototype-less object describing the current local settings of this`Http2Session`. The local settings are local to _this_`Http2Session` instance.
+         * A prototype-less object describing the current local settings of this `Http2Session`. The local settings are local to _this_`Http2Session` instance.
          * @since v8.4.0
          */
         readonly localSettings: Settings;
@@ -692,7 +692,7 @@ declare module "http2" {
         readonly originSet?: string[] | undefined;
         /**
          * Indicates whether the `Http2Session` is currently waiting for acknowledgment of
-         * a sent `SETTINGS` frame. Will be `true` after calling the`http2session.settings()` method. Will be `false` once all sent `SETTINGS`frames have been acknowledged.
+         * a sent `SETTINGS` frame. Will be `true` after calling the `http2session.settings()` method. Will be `false` once all sent `SETTINGS` frames have been acknowledged.
          * @since v8.4.0
          */
         readonly pendingSettingsAck: boolean;
@@ -722,7 +722,7 @@ declare module "http2" {
          */
         readonly state: SessionState;
         /**
-         * The `http2session.type` will be equal to`http2.constants.NGHTTP2_SESSION_SERVER` if this `Http2Session` instance is a
+         * The `http2session.type` will be equal to `http2.constants.NGHTTP2_SESSION_SERVER` if this `Http2Session` instance is a
          * server, and `http2.constants.NGHTTP2_SESSION_CLIENT` if the instance is a
          * client.
          * @since v8.4.0
@@ -739,11 +739,11 @@ declare module "http2" {
          */
         close(callback?: () => void): void;
         /**
-         * Immediately terminates the `Http2Session` and the associated `net.Socket` or`tls.TLSSocket`.
+         * Immediately terminates the `Http2Session` and the associated `net.Socket` or `tls.TLSSocket`.
          *
-         * Once destroyed, the `Http2Session` will emit the `'close'` event. If `error`is not undefined, an `'error'` event will be emitted immediately before the`'close'` event.
+         * Once destroyed, the `Http2Session` will emit the `'close'` event. If `error` is not undefined, an `'error'` event will be emitted immediately before the `'close'` event.
          *
-         * If there are any remaining open `Http2Streams` associated with the`Http2Session`, those will also be destroyed.
+         * If there are any remaining open `Http2Streams` associated with the `Http2Session`, those will also be destroyed.
          * @since v8.4.0
          * @param error An `Error` object if the `Http2Session` is being destroyed due to an error.
          * @param code The HTTP/2 error code to send in the final `GOAWAY` frame. If unspecified, and `error` is not undefined, the default is `INTERNAL_ERROR`, otherwise defaults to `NO_ERROR`.
@@ -759,17 +759,17 @@ declare module "http2" {
         goaway(code?: number, lastStreamID?: number, opaqueData?: NodeJS.ArrayBufferView): void;
         /**
          * Sends a `PING` frame to the connected HTTP/2 peer. A `callback` function must
-         * be provided. The method will return `true` if the `PING` was sent, `false`otherwise.
+         * be provided. The method will return `true` if the `PING` was sent, `false` otherwise.
          *
-         * The maximum number of outstanding (unacknowledged) pings is determined by the`maxOutstandingPings` configuration option. The default maximum is 10.
+         * The maximum number of outstanding (unacknowledged) pings is determined by the `maxOutstandingPings` configuration option. The default maximum is 10.
          *
-         * If provided, the `payload` must be a `Buffer`, `TypedArray`, or `DataView`containing 8 bytes of data that will be transmitted with the `PING` and
+         * If provided, the `payload` must be a `Buffer`, `TypedArray`, or `DataView` containing 8 bytes of data that will be transmitted with the `PING` and
          * returned with the ping acknowledgment.
          *
          * The callback will be invoked with three arguments: an error argument that will
          * be `null` if the `PING` was successfully acknowledged, a `duration` argument
          * that reports the number of milliseconds elapsed since the ping was sent and the
-         * acknowledgment was received, and a `Buffer` containing the 8-byte `PING`payload.
+         * acknowledgment was received, and a `Buffer` containing the 8-byte `PING` payload.
          *
          * ```js
          * session.ping(Buffer.from('abcdefgh'), (err, duration, payload) => {
@@ -791,7 +791,7 @@ declare module "http2" {
             callback: (err: Error | null, duration: number, payload: Buffer) => void,
         ): boolean;
         /**
-         * Calls `ref()` on this `Http2Session`instance's underlying `net.Socket`.
+         * Calls `ref()` on this `Http2Session` instance's underlying `net.Socket`.
          * @since v9.4.0
          */
         ref(): void;
@@ -822,9 +822,9 @@ declare module "http2" {
          */
         setTimeout(msecs: number, callback?: () => void): void;
         /**
-         * Updates the current local settings for this `Http2Session` and sends a new`SETTINGS` frame to the connected HTTP/2 peer.
+         * Updates the current local settings for this `Http2Session` and sends a new `SETTINGS` frame to the connected HTTP/2 peer.
          *
-         * Once called, the `http2session.pendingSettingsAck` property will be `true`while the session is waiting for the remote peer to acknowledge the new
+         * Once called, the `http2session.pendingSettingsAck` property will be `true` while the session is waiting for the remote peer to acknowledge the new
          * settings.
          *
          * The new settings will not become effective until the `SETTINGS` acknowledgment
@@ -917,15 +917,15 @@ declare module "http2" {
     }
     export interface ClientHttp2Session extends Http2Session {
         /**
-         * For HTTP/2 Client `Http2Session` instances only, the `http2session.request()`creates and returns an `Http2Stream` instance that can be used to send an
+         * For HTTP/2 Client `Http2Session` instances only, the `http2session.request()` creates and returns an `Http2Stream` instance that can be used to send an
          * HTTP/2 request to the connected server.
          *
          * When a `ClientHttp2Session` is first created, the socket may not yet be
          * connected. if `clienthttp2session.request()` is called during this time, the
          * actual request will be deferred until the socket is ready to go.
-         * If the `session` is closed before the actual request be executed, an`ERR_HTTP2_GOAWAY_SESSION` is thrown.
+         * If the `session` is closed before the actual request be executed, an `ERR_HTTP2_GOAWAY_SESSION` is thrown.
          *
-         * This method is only available if `http2session.type` is equal to`http2.constants.NGHTTP2_SESSION_CLIENT`.
+         * This method is only available if `http2session.type` is equal to `http2.constants.NGHTTP2_SESSION_CLIENT`.
          *
          * ```js
          * const http2 = require('node:http2');
@@ -1108,7 +1108,7 @@ declare module "http2" {
          * ```
          *
          * When a string is passed as an `origin`, it will be parsed as a URL and the
-         * origin will be derived. For instance, the origin for the HTTP URL`'https://example.org/foo/bar'` is the ASCII string`'https://example.org'`. An error will be thrown if either the given
+         * origin will be derived. For instance, the origin for the HTTP URL `'https://example.org/foo/bar'` is the ASCII string` 'https://example.org'`. An error will be thrown if either the given
          * string
          * cannot be parsed as a URL or if a valid origin cannot be derived.
          *
@@ -1198,6 +1198,7 @@ declare module "http2" {
         paddingStrategy?: number | undefined;
         peerMaxConcurrentStreams?: number | undefined;
         settings?: Settings | undefined;
+        remoteCustomSettings?: number[] | undefined;
         /**
          * Specifies a timeout in milliseconds that
          * a server should wait when an [`'unknownProtocol'`][] is emitted. If the
@@ -1426,7 +1427,7 @@ declare module "http2" {
         readonly aborted: boolean;
         /**
          * The request authority pseudo header field. Because HTTP/2 allows requests
-         * to set either `:authority` or `host`, this value is derived from`req.headers[':authority']` if present. Otherwise, it is derived from`req.headers['host']`.
+         * to set either `:authority` or `host`, this value is derived from `req.headers[':authority']` if present. Otherwise, it is derived from `req.headers['host']`.
          * @since v8.4.0
          */
         readonly authority: string;
@@ -1473,9 +1474,9 @@ declare module "http2" {
         readonly headers: IncomingHttpHeaders;
         /**
          * In case of server request, the HTTP version sent by the client. In the case of
-         * client response, the HTTP version of the connected-to server. Returns`'2.0'`.
+         * client response, the HTTP version of the connected-to server. Returns `'2.0'`.
          *
-         * Also `message.httpVersionMajor` is the first integer and`message.httpVersionMinor` is the second.
+         * Also `message.httpVersionMajor` is the first integer and `message.httpVersionMinor` is the second.
          * @since v8.4.0
          */
         readonly httpVersion: string;
@@ -1530,11 +1531,11 @@ declare module "http2" {
          * `destroyed`, `readable`, and `writable` properties will be retrieved from and
          * set on `request.stream`.
          *
-         * `destroy`, `emit`, `end`, `on` and `once` methods will be called on`request.stream`.
+         * `destroy`, `emit`, `end`, `on` and `once` methods will be called on `request.stream`.
          *
          * `setTimeout` method will be called on `request.stream.session`.
          *
-         * `pause`, `read`, `resume`, and `write` will throw an error with code`ERR_HTTP2_NO_SOCKET_MANIPULATION`. See `Http2Session and Sockets` for
+         * `pause`, `read`, `resume`, and `write` will throw an error with code `ERR_HTTP2_NO_SOCKET_MANIPULATION`. See `Http2Session and Sockets` for
          * more information.
          *
          * All other interactions will be routed directly to the socket. With TLS support,
@@ -1597,7 +1598,7 @@ declare module "http2" {
          * the response object.
          *
          * If no `'timeout'` listener is added to the request, the response, or
-         * the server, then `Http2Stream` s are destroyed when they time out. If a
+         * the server, then `Http2Stream`s are destroyed when they time out. If a
          * handler is assigned to the request, the response, or the server's `'timeout'`events, timed out sockets must be handled explicitly.
          * @since v8.4.0
          */
@@ -1659,6 +1660,28 @@ declare module "http2" {
          * @deprecated Since v13.0.0 - Use `socket`.
          */
         readonly connection: net.Socket | tls.TLSSocket;
+        /**
+         * Append a single header value to the header object.
+         *
+         * If the value is an array, this is equivalent to calling this method multiple times.
+         *
+         * If there were no previous values for the header, this is equivalent to calling {@link setHeader}.
+         *
+         * Attempting to set a header field name or value that contains invalid characters will result in a
+         * [TypeError](https://nodejs.org/docs/latest-v20.x/api/errors.html#class-typeerror) being thrown.
+         *
+         * ```js
+         * // Returns headers including "set-cookie: a" and "set-cookie: b"
+         * const server = http2.createServer((req, res) => {
+         *   res.setHeader('set-cookie', 'a');
+         *   res.appendHeader('set-cookie', 'b');
+         *   res.writeHead(200);
+         *   res.end('ok');
+         * });
+         * ```
+         * @since v20.12.0
+         */
+        appendHeader(name: string, value: string | string[]): void;
         /**
          * Boolean value that indicates whether the response has completed. Starts
          * as `false`. After `response.end()` executes, the value will be `true`.
@@ -1683,11 +1706,11 @@ declare module "http2" {
          * `destroyed`, `readable`, and `writable` properties will be retrieved from and
          * set on `response.stream`.
          *
-         * `destroy`, `emit`, `end`, `on` and `once` methods will be called on`response.stream`.
+         * `destroy`, `emit`, `end`, `on` and `once` methods will be called on `response.stream`.
          *
          * `setTimeout` method will be called on `response.stream.session`.
          *
-         * `pause`, `read`, `resume`, and `write` will throw an error with code`ERR_HTTP2_NO_SOCKET_MANIPULATION`. See `Http2Session and Sockets` for
+         * `pause`, `read`, `resume`, and `write` will throw an error with code `ERR_HTTP2_NO_SOCKET_MANIPULATION`. See `Http2Session and Sockets` for
          * more information.
          *
          * All other interactions will be routed directly to the socket.
@@ -1791,7 +1814,7 @@ declare module "http2" {
          * header names and the values are the respective header values. All header names
          * are lowercase.
          *
-         * The object returned by the `response.getHeaders()` method _does not_prototypically inherit from the JavaScript `Object`. This means that typical`Object` methods such as `obj.toString()`,
+         * The object returned by the `response.getHeaders()` method _does not_ prototypically inherit from the JavaScript `Object`. This means that typical `Object` methods such as `obj.toString()`,
          * `obj.hasOwnProperty()`, and others
          * are not defined and _will not work_.
          *
@@ -1865,7 +1888,7 @@ declare module "http2" {
          *
          * If no `'timeout'` listener is added to the request, the response, or
          * the server, then `Http2Stream` s are destroyed when they time out. If a
-         * handler is assigned to the request, the response, or the server's `'timeout'`events, timed out sockets must be handled explicitly.
+         * handler is assigned to the request, the response, or the server's `'timeout'` events, timed out sockets must be handled explicitly.
          * @since v8.4.0
          */
         setTimeout(msecs: number, callback?: () => void): void;
@@ -1901,7 +1924,7 @@ declare module "http2" {
         write(chunk: string | Uint8Array, encoding: BufferEncoding, callback?: (err: Error) => void): boolean;
         /**
          * Sends a status `100 Continue` to the client, indicating that the request body
-         * should be sent. See the `'checkContinue'` event on `Http2Server` and`Http2SecureServer`.
+         * should be sent. See the `'checkContinue'` event on `Http2Server` and `Http2SecureServer`.
          * @since v8.4.0
          */
         writeContinue(): void;
@@ -1952,7 +1975,7 @@ declare module "http2" {
          * `Content-Length` is given in bytes not characters. The`Buffer.byteLength()` API may be used to determine the number of bytes in a
          * given encoding. On outbound messages, Node.js does not check if Content-Length
          * and the length of the body being transmitted are equal or not. However, when
-         * receiving messages, Node.js will automatically reject messages when the`Content-Length` does not match the actual payload size.
+         * receiving messages, Node.js will automatically reject messages when the `Content-Length` does not match the actual payload size.
          *
          * This method may be called at most one time on a message before `response.end()` is called.
          *
@@ -2258,7 +2281,7 @@ declare module "http2" {
      */
     export const sensitiveHeaders: symbol;
     /**
-     * Returns an object containing the default settings for an `Http2Session`instance. This method returns a new object instance every time it is called
+     * Returns an object containing the default settings for an `Http2Session` instance. This method returns a new object instance every time it is called
      * so instances returned may be safely modified for use.
      * @since v8.4.0
      */
@@ -2287,7 +2310,7 @@ declare module "http2" {
      */
     export function getUnpackedSettings(buf: Uint8Array): Settings;
     /**
-     * Returns a `net.Server` instance that creates and manages `Http2Session`instances.
+     * Returns a `net.Server` instance that creates and manages `Http2Session` instances.
      *
      * Since there are no browsers known that support [unencrypted HTTP/2](https://http2.github.io/faq/#does-http2-require-encryption), the use of {@link createSecureServer} is necessary when
      * communicating
@@ -2323,7 +2346,7 @@ declare module "http2" {
         onRequestHandler?: (request: Http2ServerRequest, response: Http2ServerResponse) => void,
     ): Http2Server;
     /**
-     * Returns a `tls.Server` instance that creates and manages `Http2Session`instances.
+     * Returns a `tls.Server` instance that creates and manages `Http2Session` instances.
      *
      * ```js
      * const http2 = require('node:http2');
@@ -2382,6 +2405,13 @@ declare module "http2" {
         options?: ClientSessionOptions | SecureClientSessionOptions,
         listener?: (session: ClientHttp2Session, socket: net.Socket | tls.TLSSocket) => void,
     ): ClientHttp2Session;
+    /**
+     * Create an HTTP/2 server session from an existing socket.
+     * @param socket A Duplex Stream
+     * @param options Any `{@link createServer}` options can be provided.
+     * @since v20.12.0
+     */
+    export function performServerHandshake(socket: stream.Duplex, options?: ServerOptions): ServerHttp2Session;
 }
 declare module "node:http2" {
     export * from "http2";

node/https.d.ts

@@ -1,7 +1,7 @@
 /**
  * HTTPS is the HTTP protocol over TLS/SSL. In Node.js this is implemented as a
  * separate module.
- * @see [source](https://github.com/nodejs/node/blob/v20.2.0/lib/https.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.12.2/lib/https.js)
  */
 declare module "https" {
     import { Duplex } from "node:stream";

node/inspector.d.ts

@@ -20,7 +20,7 @@
  * ```js
  * import * as inspector from 'node:inspector';
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.2.0/lib/inspector.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.12.2/lib/inspector.js)
  */
 declare module 'inspector' {
     import EventEmitter = require('node:events');
@@ -2694,13 +2694,13 @@ declare module 'inspector' {
         prependOnceListener(event: 'NodeRuntime.waitingForDisconnect', listener: () => void): this;
     }
     /**
-     * Activate inspector on host and port. Equivalent to`node --inspect=[[host:]port]`, but can be done programmatically after node has
+     * Activate inspector on host and port. Equivalent to `node --inspect=[[host:]port]`, but can be done programmatically after node has
      * started.
      *
      * If wait is `true`, will block until a client has connected to the inspect port
      * and flow control has been passed to the debugger client.
      *
-     * See the `security warning` regarding the `host`parameter usage.
+     * See the `security warning` regarding the `host` parameter usage.
      * @param [port='what was specified on the CLI'] Port to listen on for inspector connections. Optional.
      * @param [host='what was specified on the CLI'] Host to listen on for inspector connections. Optional.
      * @param [wait=false] Block until a client has connected. Optional.
@@ -2731,7 +2731,7 @@ declare module 'inspector' {
      */
     function url(): string | undefined;
     /**
-     * Blocks until a client (existing or connected later) has sent`Runtime.runIfWaitingForDebugger` command.
+     * Blocks until a client (existing or connected later) has sent `Runtime.runIfWaitingForDebugger` command.
      *
      * An exception will be thrown if there is no active inspector.
      * @since v12.7.0

node/net.d.ts

@@ -10,7 +10,7 @@
  * ```js
  * const net = require('node:net');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.2.0/lib/net.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.12.2/lib/net.js)
  */
 declare module "net" {
     import * as stream from "node:stream";
@@ -363,17 +363,29 @@ declare module "net" {
          * events.EventEmitter
          *   1. close
          *   2. connect
-         *   3. data
-         *   4. drain
-         *   5. end
-         *   6. error
-         *   7. lookup
-         *   8. ready
-         *   9. timeout
+         *   3. connectionAttempt
+         *   4. connectionAttemptFailed
+         *   5. connectionAttemptTimeout
+         *   6. data
+         *   7. drain
+         *   8. end
+         *   9. error
+         *   10. lookup
+         *   11. ready
+         *   12. timeout
          */
         addListener(event: string, listener: (...args: any[]) => void): this;
         addListener(event: "close", listener: (hadError: boolean) => void): this;
         addListener(event: "connect", listener: () => void): this;
+        addListener(event: "connectionAttempt", listener: (ip: string, port: number, family: number) => void): this;
+        addListener(
+            event: "connectionAttemptFailed",
+            listener: (ip: string, port: number, family: number) => void,
+        ): this;
+        addListener(
+            event: "connectionAttemptTimeout",
+            listener: (ip: string, port: number, family: number) => void,
+        ): this;
         addListener(event: "data", listener: (data: Buffer) => void): this;
         addListener(event: "drain", listener: () => void): this;
         addListener(event: "end", listener: () => void): this;
@@ -387,6 +399,9 @@ declare module "net" {
         emit(event: string | symbol, ...args: any[]): boolean;
         emit(event: "close", hadError: boolean): boolean;
         emit(event: "connect"): boolean;
+        emit(event: "connectionAttempt", ip: string, port: number, family: number): boolean;
+        emit(event: "connectionAttemptFailed", ip: string, port: number, family: number): boolean;
+        emit(event: "connectionAttemptTimeout", ip: string, port: number, family: number): boolean;
         emit(event: "data", data: Buffer): boolean;
         emit(event: "drain"): boolean;
         emit(event: "end"): boolean;
@@ -397,6 +412,9 @@ declare module "net" {
         on(event: string, listener: (...args: any[]) => void): this;
         on(event: "close", listener: (hadError: boolean) => void): this;
         on(event: "connect", listener: () => void): this;
+        on(event: "connectionAttempt", listener: (ip: string, port: number, family: number) => void): this;
+        on(event: "connectionAttemptFailed", listener: (ip: string, port: number, family: number) => void): this;
+        on(event: "connectionAttemptTimeout", listener: (ip: string, port: number, family: number) => void): this;
         on(event: "data", listener: (data: Buffer) => void): this;
         on(event: "drain", listener: () => void): this;
         on(event: "end", listener: () => void): this;
@@ -409,6 +427,9 @@ declare module "net" {
         on(event: "timeout", listener: () => void): this;
         once(event: string, listener: (...args: any[]) => void): this;
         once(event: "close", listener: (hadError: boolean) => void): this;
+        once(event: "connectionAttempt", listener: (ip: string, port: number, family: number) => void): this;
+        once(event: "connectionAttemptFailed", listener: (ip: string, port: number, family: number) => void): this;
+        once(event: "connectionAttemptTimeout", listener: (ip: string, port: number, family: number) => void): this;
         once(event: "connect", listener: () => void): this;
         once(event: "data", listener: (data: Buffer) => void): this;
         once(event: "drain", listener: () => void): this;
@@ -423,6 +444,15 @@ declare module "net" {
         prependListener(event: string, listener: (...args: any[]) => void): this;
         prependListener(event: "close", listener: (hadError: boolean) => void): this;
         prependListener(event: "connect", listener: () => void): this;
+        prependListener(event: "connectionAttempt", listener: (ip: string, port: number, family: number) => void): this;
+        prependListener(
+            event: "connectionAttemptFailed",
+            listener: (ip: string, port: number, family: number) => void,
+        ): this;
+        prependListener(
+            event: "connectionAttemptTimeout",
+            listener: (ip: string, port: number, family: number) => void,
+        ): this;
         prependListener(event: "data", listener: (data: Buffer) => void): this;
         prependListener(event: "drain", listener: () => void): this;
         prependListener(event: "end", listener: () => void): this;
@@ -436,6 +466,18 @@ declare module "net" {
         prependOnceListener(event: string, listener: (...args: any[]) => void): this;
         prependOnceListener(event: "close", listener: (hadError: boolean) => void): this;
         prependOnceListener(event: "connect", listener: () => void): this;
+        prependOnceListener(
+            event: "connectionAttempt",
+            listener: (ip: string, port: number, family: number) => void,
+        ): this;
+        prependOnceListener(
+            event: "connectionAttemptFailed",
+            listener: (ip: string, port: number, family: number) => void,
+        ): this;
+        prependOnceListener(
+            event: "connectionAttemptTimeout",
+            listener: (ip: string, port: number, family: number) => void,
+        ): this;
         prependOnceListener(event: "data", listener: (data: Buffer) => void): this;
         prependOnceListener(event: "drain", listener: () => void): this;
         prependOnceListener(event: "end", listener: () => void): this;