@types/node 17.0.45 → 18.0.2

node v17.0/https.d.ts → 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/v17.0.0/lib/https.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/https.js)
  */
 declare module 'https' {
     import { Duplex } from 'node:stream';
@@ -34,6 +34,16 @@ declare module 'https' {
     class Server extends tls.Server {
         constructor(requestListener?: http.RequestListener);
         constructor(options: ServerOptions, requestListener?: http.RequestListener);
+        /**
+         * Closes all connections connected to this server.
+         * @since v18.2.0
+         */
+        closeAllConnections(): void;
+        /**
+         * Closes all connections connected to this server which are not sending a request or waiting for a response.
+         * @since v18.2.0
+         */
+        closeIdleConnections(): void;
         addListener(event: string, listener: (...args: any[]) => void): this;
         addListener(event: 'keylog', listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
         addListener(event: 'newSession', listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void): this;

node v17.0/index.d.ts → node/index.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for non-npm package Node.js 17.0
+// Type definitions for non-npm package Node.js 18.0
 // Project: https://nodejs.org/
 // Definitions by: Microsoft TypeScript <https://github.com/Microsoft>
 //                 DefinitelyTyped <https://github.com/DefinitelyTyped>
@@ -40,6 +40,7 @@
 //                 NodeJS Contributors <https://github.com/NodeJS>
 //                 Linus Unnebäck <https://github.com/LinusU>
 //                 wafuwafu13 <https://github.com/wafuwafu13>
+//                 Matteo Collina <https://github.com/mcollina>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 /**
@@ -113,6 +114,7 @@
 /// <reference path="stream/consumers.d.ts" />
 /// <reference path="stream/web.d.ts" />
 /// <reference path="string_decoder.d.ts" />
+/// <reference path="test.d.ts" />
 /// <reference path="timers.d.ts" />
 /// <reference path="timers/promises.d.ts" />
 /// <reference path="tls.d.ts" />

node v17.0/inspector.d.ts → node/inspector.d.ts

@@ -15,7 +15,7 @@
  * ```js
  * const inspector = require('inspector');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/inspector.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/inspector.js)
  */
 declare module 'inspector' {
     import EventEmitter = require('node:events');
@@ -1688,7 +1688,7 @@ declare module 'inspector' {
             /**
              * Controls how the trace buffer stores data.
              */
-            recordMode?: string;
+            recordMode?: string | undefined;
             /**
              * Included category filters.
              */
@@ -1778,12 +1778,6 @@ declare module 'inspector' {
          * @since v8.0.0
          */
         connect(): void;
-        /**
-         * Connects a session to the main thread inspector back-end. An exception will
-         * be thrown if this API was not called on a Worker thread.
-         * @since v12.11.0
-         */
-        connectToMainThread(): void;
         /**
          * Immediately close the session. All pending message callbacks will be called
          * with an error. `session.connect()` will need to be called to be able to send
@@ -2695,7 +2689,7 @@ 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
@@ -2717,12 +2711,12 @@ declare module 'inspector' {
      * ```console
      * $ node --inspect -p 'inspector.url()'
      * Debugger listening on ws://127.0.0.1:9229/166e272e-7a30-4d09-97ce-f1c012b43c34
-     * For help see https://nodejs.org/en/docs/inspector
+     * For help, see: https://nodejs.org/en/docs/inspector
      * ws://127.0.0.1:9229/166e272e-7a30-4d09-97ce-f1c012b43c34
      *
      * $ node --inspect=localhost:3000 -p 'inspector.url()'
      * Debugger listening on ws://localhost:3000/51cf8d0e-3c36-4c59-8efd-54519839e56a
-     * For help see https://nodejs.org/en/docs/inspector
+     * For help, see: https://nodejs.org/en/docs/inspector
      * ws://localhost:3000/51cf8d0e-3c36-4c59-8efd-54519839e56a
      *
      * $ node -p 'inspector.url()'
@@ -2738,7 +2732,10 @@ declare module 'inspector' {
      */
     function waitForDebugger(): void;
 }
+/**
+ * The inspector module provides an API for interacting with the V8 inspector.
+ */
 declare module 'node:inspector' {
-    import EventEmitter = require('inspector');
-    export = EventEmitter;
+    import inspector = require('inspector');
+    export = inspector;
 }

node v17.0/net.d.ts → node/net.d.ts

@@ -10,7 +10,7 @@
  * ```js
  * const net = require('net');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/net.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/net.js)
  */
 declare module 'net' {
     import * as stream from 'node:stream';
@@ -285,6 +285,11 @@ declare module 'net' {
          * @since v0.5.10
          */
         readonly remotePort?: number | undefined;
+        /**
+         * The socket timeout in milliseconds as set by socket.setTimeout(). It is undefined if a timeout has not been set.
+         * @since v10.7.0
+         */
+        readonly timeout?: number | undefined;
         /**
          * Half-closes the socket. i.e., it sends a FIN packet. It is possible the
          * server will still send some data.
@@ -645,7 +650,7 @@ declare module 'net' {
      *
      * The server can be a TCP server or an `IPC` server, depending on what it `listen()` to.
      *
-     * Here is an example of an TCP echo server which listens for connections
+     * Here is an example of a TCP echo server which listens for connections
      * on port 8124:
      *
      * ```js
@@ -724,19 +729,39 @@ declare module 'net' {
     function createConnection(port: number, host?: string, connectionListener?: () => void): Socket;
     function createConnection(path: string, connectionListener?: () => void): Socket;
     /**
-     * Tests if input is an IP address. Returns `0` for invalid strings,
-     * returns `4` for IP version 4 addresses, and returns `6` for IP version 6
-     * addresses.
+     * Returns `6` if `input` is an IPv6 address. Returns `4` if `input` is an IPv4
+     * address in [dot-decimal notation](https://en.wikipedia.org/wiki/Dot-decimal_notation) with no leading zeroes. Otherwise, returns`0`.
+     *
+     * ```js
+     * net.isIP('::1'); // returns 6
+     * net.isIP('127.0.0.1'); // returns 4
+     * net.isIP('127.000.000.001'); // returns 0
+     * net.isIP('127.0.0.1/24'); // returns 0
+     * net.isIP('fhqwhgads'); // returns 0
+     * ```
      * @since v0.3.0
      */
     function isIP(input: string): number;
     /**
-     * Returns `true` if input is a version 4 IP address, otherwise returns `false`.
+     * Returns `true` if `input` is an IPv4 address in [dot-decimal notation](https://en.wikipedia.org/wiki/Dot-decimal_notation) with no
+     * leading zeroes. Otherwise, returns `false`.
+     *
+     * ```js
+     * net.isIPv4('127.0.0.1'); // returns true
+     * net.isIPv4('127.000.000.001'); // returns false
+     * net.isIPv4('127.0.0.1/24'); // returns false
+     * net.isIPv4('fhqwhgads'); // returns false
+     * ```
      * @since v0.3.0
      */
     function isIPv4(input: string): boolean;
     /**
-     * Returns `true` if input is a version 6 IP address, otherwise returns `false`.
+     * Returns `true` if `input` is an IPv6 address. Otherwise, returns `false`.
+     *
+     * ```js
+     * net.isIPv6('::1'); // returns true
+     * net.isIPv6('fhqwhgads'); // returns false
+     * ```
      * @since v0.3.0
      */
     function isIPv6(input: string): boolean;

node v17.0/os.d.ts → node/os.d.ts

@@ -5,7 +5,7 @@
  * ```js
  * const os = require('os');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/os.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/os.js)
  */
 declare module 'os' {
     interface CpuInfo {
@@ -387,7 +387,7 @@ declare module 'os' {
     const EOL: string;
     /**
      * Returns the operating system CPU architecture for which the Node.js binary was
-     * compiled. Possible values are `'arm'`, `'arm64'`, `'ia32'`, `'mips'`,`'mipsel'`, `'ppc'`, `'ppc64'`, `'s390'`, `'s390x'`, `'x32'`, and `'x64'`.
+     * compiled. Possible values are `'arm'`, `'arm64'`, `'ia32'`, `'mips'`,`'mipsel'`, `'ppc'`, `'ppc64'`, `'s390'`, `'s390x'`, and `'x64'`.
      *
      * The return value is equivalent to `process.arch`.
      * @since v0.5.0
@@ -402,8 +402,9 @@ declare module 'os' {
      */
     function version(): string;
     /**
-     * Returns a string identifying the operating system platform. The value is set
-     * at compile time. Possible values are `'aix'`, `'darwin'`, `'freebsd'`,`'linux'`, `'openbsd'`, `'sunos'`, and `'win32'`.
+     * Returns a string identifying the operating system platform for which
+     * the Node.js binary was compiled. The value is set at compile time.
+     * Possible values are `'aix'`, `'darwin'`, `'freebsd'`,`'linux'`,`'openbsd'`, `'sunos'`, and `'win32'`.
      *
      * The return value is equivalent to `process.platform`.
      *

node v17.0/package.json → node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "17.0.45",
+    "version": "18.0.2",
     "description": "TypeScript definitions for Node.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -204,6 +204,11 @@
             "name": "wafuwafu13",
             "url": "https://github.com/wafuwafu13",
             "githubUsername": "wafuwafu13"
+        },
+        {
+            "name": "Matteo Collina",
+            "url": "https://github.com/mcollina",
+            "githubUsername": "mcollina"
         }
     ],
     "main": "",
@@ -215,6 +220,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "af50fb21a4ee56ffd08ac1a41afbed06689aa44fec9f855368376b13ef1742b6",
+    "typesPublisherContentHash": "fc738cc7cabdb53ec5ae23220900a87cbf1c890db6b05a41bbc65481f8ff8600",
     "typeScriptVersion": "4.0"
 }

node v17.0/path.d.ts → node/path.d.ts

@@ -13,7 +13,7 @@ declare module 'path/win32' {
  * ```js
  * const path = require('path');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/path.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/path.js)
  */
 declare module 'path' {
     namespace path {

node v17.0/perf_hooks.d.ts → node/perf_hooks.d.ts

@@ -26,7 +26,7 @@
  *   performance.measure('A to B', 'A', 'B');
  * });
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/perf_hooks.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/perf_hooks.js)
  */
 declare module 'perf_hooks' {
     import { AsyncResource } from 'node:async_hooks';
@@ -270,6 +270,9 @@ declare module 'perf_hooks' {
          *    *   }
          *    * ]
          *
+         *
+         *   performance.clearMarks();
+         *   performance.clearMeasures();
          *   observer.disconnect();
          * });
          * obs.observe({ type: 'mark' });
@@ -317,6 +320,9 @@ declare module 'perf_hooks' {
          *    * ]
          *
          *   console.log(perfObserverList.getEntriesByName('test', 'measure')); // []
+         *
+         *   performance.clearMarks();
+         *   performance.clearMeasures();
          *   observer.disconnect();
          * });
          * obs.observe({ entryTypes: ['mark', 'measure'] });
@@ -355,6 +361,8 @@ declare module 'perf_hooks' {
          *    *   }
          *    * ]
          *
+         *   performance.clearMarks();
+         *   performance.clearMeasures();
          *   observer.disconnect();
          * });
          * obs.observe({ type: 'mark' });
@@ -384,7 +392,7 @@ declare module 'perf_hooks' {
          * } = require('perf_hooks');
          *
          * const obs = new PerformanceObserver((list, observer) => {
-         *   // Called three times synchronously. `list` contains one item.
+         *   // Called once asynchronously. `list` contains three items.
          * });
          * obs.observe({ type: 'mark' });
          *

node v17.0/process.d.ts → node/process.d.ts

@@ -49,6 +49,7 @@ declare module 'process' {
                 openssl: string;
             }
             type Platform = 'aix' | 'android' | 'darwin' | 'freebsd' | 'haiku' | 'linux' | 'openbsd' | 'sunos' | 'win32' | 'cygwin' | 'netbsd';
+            type Architecture = 'arm' | 'arm64' | 'ia32' | 'mips' | 'mipsel' | 'ppc' | 'ppc64' | 's390' | 's390x' | 'x64';
             type Signals =
                 | 'SIGABRT'
                 | 'SIGALRM'
@@ -641,7 +642,7 @@ declare module 'process' {
                  * Android).
                  * @since v0.1.31
                  */
-                getgid(): number;
+                getgid?: () => number;
                 /**
                  * The `process.setgid()` method sets the group identity of the process. (See [`setgid(2)`](http://man7.org/linux/man-pages/man2/setgid.2.html).) The `id` can be passed as either a
                  * numeric ID or a group name
@@ -668,7 +669,7 @@ declare module 'process' {
                  * @since v0.1.31
                  * @param id The group name or ID
                  */
-                setgid(id: number | string): void;
+                setgid?: (id: number | string) => void;
                 /**
                  * The `process.getuid()` method returns the numeric user identity of the process.
                  * (See [`getuid(2)`](http://man7.org/linux/man-pages/man2/getuid.2.html).)
@@ -685,7 +686,7 @@ declare module 'process' {
                  * Android).
                  * @since v0.1.28
                  */
-                getuid(): number;
+                getuid?: () => number;
                 /**
                  * The `process.setuid(id)` method sets the user identity of the process. (See [`setuid(2)`](http://man7.org/linux/man-pages/man2/setuid.2.html).) The `id` can be passed as either a
                  * numeric ID or a username string.
@@ -711,7 +712,7 @@ declare module 'process' {
                  * This feature is not available in `Worker` threads.
                  * @since v0.1.28
                  */
-                setuid(id: number | string): void;
+                setuid?: (id: number | string) => void;
                 /**
                  * The `process.geteuid()` method returns the numerical effective user identity of
                  * the process. (See [`geteuid(2)`](http://man7.org/linux/man-pages/man2/geteuid.2.html).)
@@ -728,7 +729,7 @@ declare module 'process' {
                  * Android).
                  * @since v2.0.0
                  */
-                geteuid(): number;
+                geteuid?: () => number;
                 /**
                  * The `process.seteuid()` method sets the effective user identity of the process.
                  * (See [`seteuid(2)`](http://man7.org/linux/man-pages/man2/seteuid.2.html).) The `id` can be passed as either a numeric ID or a username
@@ -755,7 +756,7 @@ declare module 'process' {
                  * @since v2.0.0
                  * @param id A user name or ID
                  */
-                seteuid(id: number | string): void;
+                seteuid?: (id: number | string) => void;
                 /**
                  * The `process.getegid()` method returns the numerical effective group identity
                  * of the Node.js process. (See [`getegid(2)`](http://man7.org/linux/man-pages/man2/getegid.2.html).)
@@ -772,7 +773,7 @@ declare module 'process' {
                  * Android).
                  * @since v2.0.0
                  */
-                getegid(): number;
+                getegid?: () => number;
                 /**
                  * The `process.setegid()` method sets the effective group identity of the process.
                  * (See [`setegid(2)`](http://man7.org/linux/man-pages/man2/setegid.2.html).) The `id` can be passed as either a numeric ID or a group
@@ -799,7 +800,7 @@ declare module 'process' {
                  * @since v2.0.0
                  * @param id A group name or ID
                  */
-                setegid(id: number | string): void;
+                setegid?: (id: number | string) => void;
                 /**
                  * The `process.getgroups()` method returns an array with the supplementary group
                  * IDs. POSIX leaves it unspecified if the effective group ID is included but
@@ -817,7 +818,7 @@ declare module 'process' {
                  * Android).
                  * @since v0.9.4
                  */
-                getgroups(): number[];
+                getgroups?: () => number[];
                 /**
                  * The `process.setgroups()` method sets the supplementary group IDs for the
                  * Node.js process. This is a privileged operation that requires the Node.js
@@ -843,7 +844,7 @@ declare module 'process' {
                  * This feature is not available in `Worker` threads.
                  * @since v0.9.4
                  */
-                setgroups(groups: ReadonlyArray<string | number>): void;
+                setgroups?: (groups: ReadonlyArray<string | number>) => void;
                 /**
                  * The `process.setUncaughtExceptionCaptureCallback()` function sets a function
                  * that will be invoked when an uncaught exception occurs, which will receive the
@@ -1040,7 +1041,7 @@ declare module 'process' {
                 title: string;
                 /**
                  * The operating system CPU architecture for which the Node.js binary was compiled.
-                 * Possible values are: `'arm'`, `'arm64'`, `'ia32'`, `'mips'`,`'mipsel'`, `'ppc'`,`'ppc64'`, `'s390'`, `'s390x'`, `'x32'`, and `'x64'`.
+                 * Possible values are: `'arm'`, `'arm64'`, `'ia32'`, `'mips'`,`'mipsel'`, `'ppc'`,`'ppc64'`, `'s390'`, `'s390x'`, and `'x64'`.
                  *
                  * ```js
                  * import { arch } from 'process';
@@ -1049,10 +1050,10 @@ declare module 'process' {
                  * ```
                  * @since v0.5.0
                  */
-                readonly arch: string;
+                readonly arch: Architecture;
                 /**
                  * The `process.platform` property returns a string identifying the operating
-                 * system platform on which the Node.js process is running.
+                 * system platform for which the Node.js binary was compiled.
                  *
                  * Currently possible values are:
                  *

node v17.0/punycode.d.ts → node/punycode.d.ts

@@ -24,7 +24,7 @@
  * made available to developers as a convenience. Fixes or other modifications to
  * the module must be directed to the [Punycode.js](https://github.com/bestiejs/punycode.js) project.
  * @deprecated Since v7.0.0 - Deprecated
- * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/punycode.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/punycode.js)
  */
 declare module 'punycode' {
     /**

node v17.0/querystring.d.ts → node/querystring.d.ts

@@ -9,7 +9,7 @@
  * The `querystring` API is considered Legacy. While it is still maintained,
  * new code should use the `URLSearchParams` API instead.
  * @deprecated Legacy
- * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/querystring.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/querystring.js)
  */
 declare module 'querystring' {
     interface StringifyOptions {

node v17.0/readline.d.ts → node/readline.d.ts

@@ -17,7 +17,7 @@
  *
  * ```js
  * import * as readline from 'node:readline/promises';
- * import { stdin as input, stdout as output } from 'process';
+ * import { stdin as input, stdout as output } from 'node:process';
  *
  * const rl = readline.createInterface({ input, output });
  *
@@ -30,7 +30,7 @@
  *
  * Once this code is invoked, the Node.js application will not terminate until the`readline.Interface` is closed because the interface waits for data to be
  * received on the `input` stream.
- * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/readline.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/readline.js)
  */
 declare module 'readline' {
     import { Abortable, EventEmitter } from 'node:events';

node v17.0/repl.d.ts → node/repl.d.ts

@@ -6,7 +6,7 @@
  * ```js
  * const repl = require('repl');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/repl.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/repl.js)
  */
 declare module 'repl' {
     import { Interface, Completer, AsyncCompleter } from 'node:readline';
@@ -277,7 +277,7 @@ declare module 'repl' {
          * Goodbye!
          * ```
          * @since v0.3.0
-         * @param keyword The command keyword (*without* a leading `.` character).
+         * @param keyword The command keyword (_without_ a leading `.` character).
          * @param cmd The function to invoke when the command is processed.
          */
         defineCommand(keyword: string, cmd: REPLCommandAction | REPLCommand): void;