@types/node 16.18.110 → 16.18.112

node v16.18/console.d.ts

@@ -6,7 +6,7 @@
  *
  * * A `Console` class with methods such as `console.log()`, `console.error()`, and `console.warn()` that can be used to write to any Node.js stream.
  * * A global `console` instance configured to write to [`process.stdout`](https://nodejs.org/docs/latest-v16.x/api/process.html#processstdout) and
- * [`process.stderr`](https://nodejs.org/docs/latest-v16.x/api/process.html#processstderr). The global `console` can be used without calling `require('node:console')`.
+ * [`process.stderr`](https://nodejs.org/docs/latest-v16.x/api/process.html#processstderr). The global `console` can be used without importing the `node:console` module.
  *
  * _**Warning**_: The global console object's methods are neither consistently
  * synchronous like the browser APIs they resemble, nor are they consistently
@@ -362,7 +362,7 @@ declare module "node:console" {
          *
          * * A `Console` class with methods such as `console.log()`, `console.error()` and `console.warn()` that can be used to write to any Node.js stream.
          * * A global `console` instance configured to write to [`process.stdout`](https://nodejs.org/docs/latest-v16.x/api/process.html#processstdout) and
-         * [`process.stderr`](https://nodejs.org/docs/latest-v16.x/api/process.html#processstderr). The global `console` can be used without calling `require('console')`.
+         * [`process.stderr`](https://nodejs.org/docs/latest-v16.x/api/process.html#processstderr). The global `console` can be used without importing the `node:console` module.
          *
          * _**Warning**_: The global console object's methods are neither consistently
          * synchronous like the browser APIs they resemble, nor are they consistently

node v16.18/crypto.d.ts

@@ -3957,7 +3957,7 @@ declare module "crypto" {
             saltLength: number;
         }
         /**
-         * Calling `require('node:crypto').webcrypto` returns an instance of the `Crypto` class.
+         * Importing the `webcrypto` object (`import { webcrypto } from 'node:crypto'`) gives an instance of the `Crypto` class.
          * `Crypto` is a singleton that provides access to the remainder of the crypto API.
          * @since v15.0.0
          */

node v16.18/dns/promises.d.ts

@@ -1,7 +1,7 @@
 /**
  * The `dns.promises` API provides an alternative set of asynchronous DNS methods
  * that return `Promise` objects rather than using callbacks. The API is accessible
- * via `require('node:dns').promises` or `require('node:dns/promises')`.
+ * via `import { promises } from 'node:dns'` or `import dnsPromises from 'node:dns/promises'`.
  * @since v10.6.0
  */
 declare module "dns/promises" {
@@ -60,7 +60,7 @@ declare module "dns/promises" {
      * Example usage:
      *
      * ```js
-     * const dns = require('node:dns');
+     * import dns from 'node:dns';
      * const dnsPromises = dns.promises;
      * const options = {
      *   family: 6,
@@ -96,8 +96,8 @@ declare module "dns/promises" {
      * On error, the `Promise` is rejected with an [`Error`](https://nodejs.org/docs/latest-v16.x/api/errors.html#class-error) object, where `err.code` is the error code.
      *
      * ```js
-     * const dnsPromises = require('node:dns').promises;
-     * dnsPromises.lookupService('127.0.0.1', 22).then((result) => {
+     * import dns from 'node:dns';
+     * dns.promises.lookupService('127.0.0.1', 22).then((result) => {
      *   console.log(result.hostname, result.service);
      *   // Prints: localhost ssh
      * });
@@ -383,7 +383,8 @@ declare module "dns/promises" {
      * other resolvers:
      *
      * ```js
-     * const { Resolver } = require('node:dns').promises;
+     * import dns from 'node:dns';
+     * const { Resolver } = dns.promises;
      * const resolver = new Resolver();
      * resolver.setServers(['4.4.4.4']);
      *

node v16.18/dns.d.ts

@@ -9,7 +9,7 @@
  * system do, use {@link lookup}.
  *
  * ```js
- * const dns = require('node:dns');
+ * import dns from 'node:dns';
  *
  * dns.lookup('example.org', (err, address, family) => {
  *   console.log('address: %j family: IPv%s', address, family);
@@ -23,7 +23,7 @@
  * DNS queries, bypassing other name-resolution facilities.
  *
  * ```js
- * const dns = require('node:dns');
+ * import dns from 'node:dns';
  *
  * dns.resolve4('archive.org', (err, addresses) => {
  *   if (err) throw err;
@@ -129,7 +129,7 @@ declare module "dns" {
      * Example usage:
      *
      * ```js
-     * const dns = require('node:dns');
+     * import dns from 'node:dns';
      * const options = {
      *   family: 6,
      *   hints: dns.ADDRCONFIG | dns.V4MAPPED,
@@ -189,7 +189,7 @@ declare module "dns" {
      * where `err.code` is the error code.
      *
      * ```js
-     * const dns = require('node:dns');
+     * import dns from 'node:dns';
      * dns.lookupService('127.0.0.1', 22, (err, hostname, service) => {
      *   console.log(hostname, service);
      *   // Prints: localhost ssh
@@ -766,7 +766,7 @@ declare module "dns" {
      * other resolvers:
      *
      * ```js
-     * const { Resolver } = require('node:dns');
+     * import { Resolver } from 'node:dns';
      * const resolver = new Resolver();
      * resolver.setServers(['4.4.4.4']);
      *

node v16.18/domain.d.ts

@@ -63,8 +63,8 @@ declare module "domain" {
          * This is the most basic way to use a domain.
          *
          * ```js
-         * const domain = require('domain');
-         * const fs = require('fs');
+         * import domain from 'node:domain';
+         * import fs from 'node:fs';
          * const d = domain.create();
          * d.on('error', (er) => {
          *   console.error('Caught error!', er);

node v16.18/events.d.ts

@@ -22,7 +22,7 @@
  * the `eventEmitter.emit()` method is used to trigger the event.
  *
  * ```js
- * const EventEmitter = require('events');
+ * import EventEmitter from 'node:events';
  *
  * class MyEmitter extends EventEmitter {}
  *
@@ -79,7 +79,7 @@ declare module "events" {
      * The `EventEmitter` class is defined and exposed by the `events` module:
      *
      * ```js
-     * const EventEmitter = require('events');
+     * import EventEmitter from 'node:events';
      * ```
      *
      * All `EventEmitter`s emit the event `'newListener'` when new listeners are
@@ -103,7 +103,7 @@ declare module "events" {
          * semantics and does not listen to the `'error'` event.
          *
          * ```js
-         * const { once, EventEmitter } = require('events');
+         * import { once, EventEmitter } from 'node:events';
          *
          * async function run() {
          *   const ee = new EventEmitter();
@@ -135,7 +135,7 @@ declare module "events" {
          * special handling:
          *
          * ```js
-         * const { EventEmitter, once } = require('events');
+         * import { EventEmitter, once } from 'node:events';
          *
          * const ee = new EventEmitter();
          *
@@ -151,7 +151,7 @@ declare module "events" {
          * An `AbortSignal` can be used to cancel waiting for the event:
          *
          * ```js
-         * const { EventEmitter, once } = require('events');
+         * import { EventEmitter, once } from 'node:events';
          *
          * const ee = new EventEmitter();
          * const ac = new AbortController();
@@ -183,7 +183,7 @@ declare module "events" {
         static once(emitter: DOMEventTarget, eventName: string, options?: StaticEventEmitterOptions): Promise<any[]>;
         /**
          * ```js
-         * const { on, EventEmitter } = require('events');
+         * import { on, EventEmitter } from 'node:events';
          *
          * (async () => {
          *   const ee = new EventEmitter();
@@ -212,7 +212,7 @@ declare module "events" {
          * An `AbortSignal` can be used to cancel waiting on events:
          *
          * ```js
-         * const { on, EventEmitter } = require('events');
+         * import { on, EventEmitter } from 'node:events';
          * const ac = new AbortController();
          *
          * (async () => {
@@ -248,7 +248,7 @@ declare module "events" {
          * A class method that returns the number of listeners for the given `eventName`registered on the given `emitter`.
          *
          * ```js
-         * const { EventEmitter, listenerCount } = require('events');
+         * import { EventEmitter, listenerCount } from 'node:events';
          * const myEmitter = new EventEmitter();
          * myEmitter.on('event', () => {});
          * myEmitter.on('event', () => {});
@@ -271,7 +271,7 @@ declare module "events" {
          * event target. This is useful for debugging and diagnostic purposes.
          *
          * ```js
-         * const { getEventListeners, EventEmitter } = require('events');
+         * import { getEventListeners, EventEmitter } from 'node:events';
          *
          * {
          *   const ee = new EventEmitter();
@@ -291,10 +291,10 @@ declare module "events" {
         static getEventListeners(emitter: DOMEventTarget | NodeJS.EventEmitter, name: string | symbol): Function[];
         /**
          * ```js
-         * const {
+         * import {
          *   setMaxListeners,
          *   EventEmitter
-         * } = require('events');
+         * } from 'node:events';
          *
          * const target = new EventTarget();
          * const emitter = new EventEmitter();
@@ -610,7 +610,7 @@ declare module "events" {
                  * Returns `true` if the event had listeners, `false` otherwise.
                  *
                  * ```js
-                 * const EventEmitter = require('events');
+                 * import EventEmitter from 'node:events';
                  * const myEmitter = new EventEmitter();
                  *
                  * // First listener
@@ -689,7 +689,7 @@ declare module "events" {
                  * listeners. The values in the array are strings or `Symbol`s.
                  *
                  * ```js
-                 * const EventEmitter = require('events');
+                 * import EventEmitter from 'node:events';
                  * const myEE = new EventEmitter();
                  * myEE.on('foo', () => {});
                  * myEE.on('bar', () => {});

node v16.18/fs/promises.d.ts

@@ -830,7 +830,7 @@ declare module "fs/promises" {
      * The `fsPromises.mkdtemp()` method will append the six randomly selected
      * characters directly to the `prefix` string. For instance, given a directory`/tmp`, if the intention is to create a temporary directory _within_`/tmp`, the`prefix` must end with a trailing
      * platform-specific path separator
-     * (`require('path').sep`).
+     * (`import { sep } from 'node:path'`).
      * @since v10.0.0
      * @return Fulfills with a string containing the filesystem path of the newly created temporary directory.
      */
@@ -1050,7 +1050,7 @@ declare module "fs/promises" {
      * Returns an async iterator that watches for changes on `filename`, where `filename`is either a file or a directory.
      *
      * ```js
-     * const { watch } = require('fs/promises');
+     * import { watch } from 'node:fs/promises';
      *
      * const ac = new AbortController();
      * const { signal } = ac;

node v16.18/fs.d.ts

@@ -1747,7 +1747,7 @@ declare module "fs" {
      * The `fs.mkdtemp()` method will append the six randomly selected characters
      * directly to the `prefix` string. For instance, given a directory `/tmp`, if the
      * intention is to create a temporary directory _within_`/tmp`, the `prefix`must end with a trailing platform-specific path separator
-     * (`require('path').sep`).
+     * (`import { sep } from 'node:path'`).
      *
      * ```js
      * import { tmpdir } from 'os';

node v16.18/globals.d.ts

@@ -224,20 +224,6 @@ declare namespace NodeJS {
         unref(): this;
     }
 
-    type TypedArray =
-        | Uint8Array
-        | Uint8ClampedArray
-        | Uint16Array
-        | Uint32Array
-        | Int8Array
-        | Int16Array
-        | Int32Array
-        | BigUint64Array
-        | BigInt64Array
-        | Float32Array
-        | Float64Array;
-    type ArrayBufferView = TypedArray | DataView;
-
     interface Require {
         (id: string): any;
         resolve: RequireResolve;

node v16.18/globals.typedarray.d.ts

@@ -0,0 +1,21 @@
+export {}; // Make this a module
+
+declare global {
+    namespace NodeJS {
+        type TypedArray<TArrayBuffer extends ArrayBufferLike = ArrayBufferLike> =
+            | Uint8Array<TArrayBuffer>
+            | Uint8ClampedArray<TArrayBuffer>
+            | Uint16Array<TArrayBuffer>
+            | Uint32Array<TArrayBuffer>
+            | Int8Array<TArrayBuffer>
+            | Int16Array<TArrayBuffer>
+            | Int32Array<TArrayBuffer>
+            | BigUint64Array<TArrayBuffer>
+            | BigInt64Array<TArrayBuffer>
+            | Float32Array<TArrayBuffer>
+            | Float64Array<TArrayBuffer>;
+        type ArrayBufferView<TArrayBuffer extends ArrayBufferLike = ArrayBufferLike> =
+            | TypedArray<TArrayBuffer>
+            | DataView<TArrayBuffer>;
+    }
+}

node v16.18/http.d.ts

@@ -1,5 +1,5 @@
 /**
- * To use the HTTP server and client one must `require('http')`.
+ * To use the HTTP server and client one must import the `node:http` module.
  *
  * The HTTP interfaces in Node.js are designed to support many features
  * of the protocol which have been traditionally difficult to use.
@@ -1315,7 +1315,7 @@ declare module "http" {
      * upload a file with a POST request, then write to the `ClientRequest` object.
      *
      * ```js
-     * const http = require('http');
+     * import http from 'node:http';
      *
      * const postData = JSON.stringify({
      *   'msg': 'Hello World!'

node v16.18/http2.d.ts

@@ -3,7 +3,7 @@
  * It can be accessed using:
  *
  * ```js
- * const http2 = require('http2');
+ * import http2 from 'node:http2';
  * ```
  * @since v8.4.0
  * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/http2.js)
@@ -157,7 +157,7 @@ declare module "http2" {
         priority(options: StreamPriorityOptions): void;
         /**
          * ```js
-         * const http2 = require('http2');
+         * import http2 from 'node:http2';
          * const client = http2.connect('http://example.org:8000');
          * const { NGHTTP2_CANCEL } = http2.constants;
          * const req = client.request({ ':path': '/' });
@@ -177,7 +177,7 @@ declare module "http2" {
          * trailers can be sent.
          *
          * ```js
-         * const http2 = require('http2');
+         * import http2 from 'node:http2';
          * const server = http2.createServer();
          * server.on('stream', (stream) => {
          *   stream.respond(undefined, { waitForTrailers: true });
@@ -368,7 +368,7 @@ declare module "http2" {
          * 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('http2');
+         * import http2 from 'node:http2';
          * const server = http2.createServer();
          * server.on('stream', (stream) => {
          *   stream.respond({ ':status': 200 });
@@ -400,7 +400,7 @@ declare module "http2" {
         ): void;
         /**
          * ```js
-         * const http2 = require('http2');
+         * import http2 from 'node:http2';
          * const server = http2.createServer();
          * server.on('stream', (stream) => {
          *   stream.respond({ ':status': 200 });
@@ -416,7 +416,7 @@ declare module "http2" {
          * 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('http2');
+         * import http2 from 'node:http2';
          * const server = http2.createServer();
          * server.on('stream', (stream) => {
          *   stream.respond({ ':status': 200 }, { waitForTrailers: true });
@@ -439,8 +439,8 @@ declare module "http2" {
          * automatically.
          *
          * ```js
-         * const http2 = require('http2');
-         * const fs = require('fs');
+         * import http2 from 'node:http2';
+         * import fs from 'node:fs';
          *
          * const server = http2.createServer();
          * server.on('stream', (stream) => {
@@ -482,8 +482,8 @@ declare module "http2" {
          * or `http2stream.close()` to close the `Http2Stream`.
          *
          * ```js
-         * const http2 = require('http2');
-         * const fs = require('fs');
+         * import http2 from 'node:http2';
+         * import fs from 'node:fs';
          *
          * const server = http2.createServer();
          * server.on('stream', (stream) => {
@@ -529,7 +529,7 @@ declare module "http2" {
          * Example using a file path:
          *
          * ```js
-         * const http2 = require('http2');
+         * import http2 from 'node:http2';
          * const server = http2.createServer();
          * server.on('stream', (stream) => {
          *   function statCheck(stat, headers) {
@@ -563,7 +563,7 @@ declare module "http2" {
          * results to determine if the file has been modified to return an appropriate `304` response:
          *
          * ```js
-         * const http2 = require('http2');
+         * import http2 from 'node:http2';
          * const server = http2.createServer();
          * server.on('stream', (stream) => {
          *   function statCheck(stat, headers) {
@@ -596,7 +596,7 @@ declare module "http2" {
          * 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('http2');
+         * import http2 from 'node:http2';
          * const server = http2.createServer();
          * server.on('stream', (stream) => {
          *   stream.respondWithFile('/some/file',
@@ -805,7 +805,7 @@ declare module "http2" {
          * the delta.
          *
          * ```js
-         * const http2 = require('http2');
+         * import http2 from 'node:http2';
          *
          * const server = http2.createServer();
          * const expectedWindowSize = 2 ** 20;
@@ -927,7 +927,7 @@ declare module "http2" {
          * This method is only available if `http2session.type` is equal to`http2.constants.NGHTTP2_SESSION_CLIENT`.
          *
          * ```js
-         * const http2 = require('http2');
+         * import http2 from 'node:http2';
          * const clientSession = http2.connect('https://localhost:1234');
          * const {
          *   HTTP2_HEADER_PATH,
@@ -1060,7 +1060,7 @@ declare module "http2" {
          * Submits an `ALTSVC` frame (as defined by [RFC 7838](https://tools.ietf.org/html/rfc7838)) to the connected client.
          *
          * ```js
-         * const http2 = require('http2');
+         * import http2 from 'node:http2';
          *
          * const server = http2.createServer();
          * server.on('session', (session) => {
@@ -1101,7 +1101,7 @@ declare module "http2" {
          * authoritative responses.
          *
          * ```js
-         * const http2 = require('http2');
+         * import http2 from 'node:http2';
          * const options = getSecureOptionsSomehow();
          * const server = http2.createSecureServer(options);
          * server.on('stream', (stream) => {
@@ -1127,7 +1127,7 @@ declare module "http2" {
          * server using the `http2.createSecureServer()` method:
          *
          * ```js
-         * const http2 = require('http2');
+         * import http2 from 'node:http2';
          * const options = getSecureOptionsSomehow();
          * options.origins = ['https://example.com', 'https://example.org'];
          * const server = http2.createSecureServer(options);
@@ -1807,7 +1807,7 @@ declare module "http2" {
          * All other interactions will be routed directly to the socket.
          *
          * ```js
-         * const http2 = require('http2');
+         * import http2 from 'node:http2';
          * const server = http2.createServer((req, res) => {
          *   const ip = req.socket.remoteAddress;
          *   const port = req.socket.remotePort;
@@ -2358,7 +2358,7 @@ declare module "http2" {
      * for use with the `HTTP2-Settings` header field.
      *
      * ```js
-     * const http2 = require('http2');
+     * import http2 from 'node:http2';
      *
      * const packed = http2.getPackedSettings({ enablePush: false });
      *
@@ -2383,7 +2383,7 @@ declare module "http2" {
      * with browser clients.
      *
      * ```js
-     * const http2 = require('http2');
+     * import http2 from 'node:http2';
      *
      * // Create an unencrypted HTTP/2 server.
      * // Since there are no browsers known that support
@@ -2420,8 +2420,8 @@ declare module "http2" {
      * Returns a `tls.Server` instance that creates and manages `Http2Session` instances.
      *
      * ```js
-     * const http2 = require('http2');
-     * const fs = require('fs');
+     * import http2 from 'node:http2';
+     * import fs from 'node:fs';
      *
      * const options = {
      *   key: fs.readFileSync('server-key.pem'),
@@ -2460,7 +2460,7 @@ declare module "http2" {
      * Returns a `ClientHttp2Session` instance.
      *
      * ```js
-     * const http2 = require('http2');
+     * import http2 from 'node:http2';
      * const client = http2.connect('https://localhost:1234');
      *
      * // Use the client

node v16.18/https.d.ts

@@ -260,8 +260,8 @@ declare module "https" {
     /**
      * ```js
      * // curl -k https://localhost:8000/
-     * const https = require('https');
-     * const fs = require('fs');
+     * import https from 'node:https';
+     * import fs from 'node:fs';
      *
      * const options = {
      *   key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),
@@ -277,8 +277,8 @@ declare module "https" {
      * Or
      *
      * ```js
-     * const https = require('https');
-     * const fs = require('fs');
+     * import https from 'node:https';
+     * import fs from 'node:fs';
      *
      * const options = {
      *   pfx: fs.readFileSync('test/fixtures/test_cert.pfx'),
@@ -318,7 +318,7 @@ declare module "https" {
      * upload a file with a POST request, then write to the `ClientRequest` object.
      *
      * ```js
-     * const https = require('https');
+     * import https from 'node:https';
      *
      * const options = {
      *   hostname: 'encrypted.google.com',
@@ -391,9 +391,9 @@ declare module "https" {
      * Example pinning on certificate fingerprint, or the public key (similar to`pin-sha256`):
      *
      * ```js
-     * const tls = require('tls');
-     * const https = require('https');
-     * const crypto = require('crypto');
+     * import tls from 'node:tls';
+     * import https from 'node:https';
+     * import crypto from 'node:crypto';
      *
      * function sha256(s) {
      *   return crypto.createHash('sha256').update(s).digest('base64');
@@ -501,7 +501,7 @@ declare module "https" {
      * string, it is automatically parsed with `new URL()`. If it is a `URL` object, it will be automatically converted to an ordinary `options` object.
      *
      * ```js
-     * const https = require('https');
+     * import https from 'node:https';
      *
      * https.get('https://encrypted.google.com/', (res) => {
      *   console.log('statusCode:', res.statusCode);

node v16.18/index.d.ts

@@ -22,7 +22,7 @@
  * IN THE SOFTWARE.
  */
 
-// NOTE: These definitions support NodeJS and TypeScript 4.9+.
+// NOTE: These definitions support NodeJS and TypeScript 5.7+.
 
 // Reference required types from the default lib:
 /// <reference lib="es2020" />
@@ -30,6 +30,10 @@
 /// <reference lib="esnext.intl" />
 /// <reference lib="esnext.bigint" />
 
+// Definitions specific to TypeScript 5.7+
+/// <reference path="globals.typedarray.d.ts" />
+/// <reference path="buffer.buffer.d.ts" />
+
 // Base definitions for all NodeJS modules that are not specific to any version of TypeScript:
 /// <reference path="assert.d.ts" />
 /// <reference path="assert/strict.d.ts" />

node v16.18/inspector.d.ts

@@ -11,7 +11,7 @@
  * It can be accessed using:
  *
  * ```js
- * const inspector = require('inspector');
+ * import inspector from 'node:inspector';
  * ```
  * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/inspector.js)
  */

node v16.18/module.d.ts

@@ -11,9 +11,9 @@ declare module "module" {
          * does not add or remove exported names from the `ES Modules`.
          *
          * ```js
-         * const fs = require('fs');
-         * const assert = require('assert');
-         * const { syncBuiltinESMExports } = require('module');
+         * import fs from 'node:fs';
+         * import assert from 'node:assert';
+         * import { syncBuiltinESMExports } from 'node:module';
          *
          * fs.readFile = newAPI;
          *

node v16.18/net.d.ts

@@ -8,7 +8,7 @@
  * It can be accessed using:
  *
  * ```js
- * const net = require('net');
+ * import net from 'node:net';
  * ```
  * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/net.js)
  */
@@ -717,7 +717,7 @@ declare module "net" {
      * on port 8124:
      *
      * ```js
-     * const net = require('net');
+     * import net from 'node:net';
      * const server = net.createServer((c) => {
      *   // 'connection' listener.
      *   console.log('client connected');

node v16.18/os.d.ts

@@ -3,7 +3,7 @@
  * properties. It can be accessed using:
  *
  * ```js
- * const os = require('os');
+ * import os from 'node:os';
  * ```
  * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/os.js)
  */