@types/node 20.16.8 → 20.16.10

node v20.16/https.d.ts

@@ -270,8 +270,8 @@ declare module "https" {
     /**
      * ```js
      * // curl -k https://localhost:8000/
-     * const https = require('node:https');
-     * const fs = require('node:fs');
+     * import https from 'node:https';
+     * import fs from 'node:fs';
      *
      * const options = {
      *   key: fs.readFileSync('test/fixtures/keys/agent2-key.pem'),
@@ -287,8 +287,8 @@ declare module "https" {
      * Or
      *
      * ```js
-     * const https = require('node:https');
-     * const fs = require('node:fs');
+     * import https from 'node:https';
+     * import fs from 'node:fs';
      *
      * const options = {
      *   pfx: fs.readFileSync('test/fixtures/test_cert.pfx'),
@@ -328,7 +328,7 @@ declare module "https" {
      * upload a file with a POST request, then write to the `ClientRequest` object.
      *
      * ```js
-     * const https = require('node:https');
+     * import https from 'node:https';
      *
      * const options = {
      *   hostname: 'encrypted.google.com',
@@ -401,9 +401,9 @@ declare module "https" {
      * Example pinning on certificate fingerprint, or the public key (similar to`pin-sha256`):
      *
      * ```js
-     * const tls = require('node:tls');
-     * const https = require('node:https');
-     * const crypto = require('node: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');
@@ -511,7 +511,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('node:https');
+     * import https from 'node:https';
      *
      * https.get('https://encrypted.google.com/', (res) => {
      *   console.log('statusCode:', res.statusCode);

node v20.16/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 v20.16/module.d.ts

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

node v20.16/net.d.ts

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

node v20.16/os.d.ts

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

node v20.16/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "20.16.8",
+    "version": "20.16.10",
     "description": "TypeScript definitions for node",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -203,6 +203,13 @@
     ],
     "main": "",
     "types": "index.d.ts",
+    "typesVersions": {
+        "<=5.6": {
+            "*": [
+                "ts5.6/*"
+            ]
+        }
+    },
     "repository": {
         "type": "git",
         "url": "https://github.com/DefinitelyTyped/DefinitelyTyped.git",
@@ -212,6 +219,6 @@
     "dependencies": {
         "undici-types": "~6.19.2"
     },
-    "typesPublisherContentHash": "fadd0ba4a68bcdb592deff9b69f3319537c5647439cbbf1b6144f5881f92f523",
+    "typesPublisherContentHash": "2f4c1b55d9201830070bc7c8dcc43b9c8024dc917c1ed90429ecdb7e50018259",
     "typeScriptVersion": "4.8"
 }

node v20.16/path.d.ts

@@ -11,7 +11,7 @@ declare module "path/win32" {
  * paths. It can be accessed using:
  *
  * ```js
- * const path = require('node:path');
+ * import path from 'node:path';
  * ```
  * @see [source](https://github.com/nodejs/node/blob/v20.13.1/lib/path.js)
  */

node v20.16/perf_hooks.d.ts

@@ -10,7 +10,7 @@
  * * [Resource Timing](https://www.w3.org/TR/resource-timing-2/)
  *
  * ```js
- * const { PerformanceObserver, performance } = require('node:perf_hooks');
+ * import { PerformanceObserver, performance } from 'node:perf_hooks';
  *
  * const obs = new PerformanceObserver((items) => {
  *   console.log(items.getEntries()[0].duration);
@@ -348,10 +348,10 @@ declare module "perf_hooks" {
          * A `PerformanceObserver` must be subscribed to the `'function'` event type in order for the timing details to be accessed.
          *
          * ```js
-         * const {
+         * import {
          *   performance,
          *   PerformanceObserver,
-         * } = require('node:perf_hooks');
+         * } from 'node:perf_hooks';
          *
          * function someFunction() {
          *   console.log('hello world');
@@ -390,10 +390,10 @@ declare module "perf_hooks" {
          * with respect to `performanceEntry.startTime`.
          *
          * ```js
-         * const {
+         * import {
          *   performance,
          *   PerformanceObserver,
-         * } = require('node:perf_hooks');
+         * } from 'node:perf_hooks';
          *
          * const obs = new PerformanceObserver((perfObserverList, observer) => {
          *   console.log(perfObserverList.getEntries());
@@ -433,10 +433,10 @@ declare module "perf_hooks" {
          * equal to `name`, and optionally, whose `performanceEntry.entryType` is equal to`type`.
          *
          * ```js
-         * const {
+         * import {
          *   performance,
          *   PerformanceObserver,
-         * } = require('node:perf_hooks');
+         * } from 'node:perf_hooks';
          *
          * const obs = new PerformanceObserver((perfObserverList, observer) => {
          *   console.log(perfObserverList.getEntriesByName('meow'));
@@ -484,10 +484,10 @@ declare module "perf_hooks" {
          * with respect to `performanceEntry.startTime` whose `performanceEntry.entryType` is equal to `type`.
          *
          * ```js
-         * const {
+         * import {
          *   performance,
          *   PerformanceObserver,
-         * } = require('node:perf_hooks');
+         * } from 'node:perf_hooks';
          *
          * const obs = new PerformanceObserver((perfObserverList, observer) => {
          *   console.log(perfObserverList.getEntriesByType('mark'));
@@ -537,10 +537,10 @@ declare module "perf_hooks" {
          * Subscribes the `PerformanceObserver` instance to notifications of new `PerformanceEntry` instances identified either by `options.entryTypes` or `options.type`:
          *
          * ```js
-         * const {
+         * import {
          *   performance,
          *   PerformanceObserver,
-         * } = require('node:perf_hooks');
+         * } from 'node:perf_hooks';
          *
          * const obs = new PerformanceObserver((list, observer) => {
          *   // Called once asynchronously. `list` contains three items.
@@ -809,7 +809,7 @@ declare module "perf_hooks" {
      * detect.
      *
      * ```js
-     * const { monitorEventLoopDelay } = require('node:perf_hooks');
+     * import { monitorEventLoopDelay } from 'node:perf_hooks';
      * const h = monitorEventLoopDelay({ resolution: 20 });
      * h.enable();
      * // Do something.
@@ -858,7 +858,7 @@ declare module "perf_hooks" {
     } from "perf_hooks";
     global {
         /**
-         * `PerformanceEntry` is a global reference for `require('node:perf_hooks').PerformanceEntry`
+         * `PerformanceEntry` is a global reference for `import { PerformanceEntry } from 'node:node:perf_hooks'`
          * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performanceentry
          * @since v19.0.0
          */
@@ -868,7 +868,7 @@ declare module "perf_hooks" {
         } ? T
             : typeof _PerformanceEntry;
         /**
-         * `PerformanceMark` is a global reference for `require('node:perf_hooks').PerformanceMark`
+         * `PerformanceMark` is a global reference for `import { PerformanceMark } from 'node:node:perf_hooks'`
          * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performancemark
          * @since v19.0.0
          */
@@ -878,7 +878,7 @@ declare module "perf_hooks" {
         } ? T
             : typeof _PerformanceMark;
         /**
-         * `PerformanceMeasure` is a global reference for `require('node:perf_hooks').PerformanceMeasure`
+         * `PerformanceMeasure` is a global reference for `import { PerformanceMeasure } from 'node:node:perf_hooks'`
          * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performancemeasure
          * @since v19.0.0
          */
@@ -888,7 +888,7 @@ declare module "perf_hooks" {
         } ? T
             : typeof _PerformanceMeasure;
         /**
-         * `PerformanceObserver` is a global reference for `require('node:perf_hooks').PerformanceObserver`
+         * `PerformanceObserver` is a global reference for `import { PerformanceObserver } from 'node:node:perf_hooks'`
          * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performanceobserver
          * @since v19.0.0
          */
@@ -898,7 +898,7 @@ declare module "perf_hooks" {
         } ? T
             : typeof _PerformanceObserver;
         /**
-         * `PerformanceObserverEntryList` is a global reference for `require('node:perf_hooks').PerformanceObserverEntryList`
+         * `PerformanceObserverEntryList` is a global reference for `import { PerformanceObserverEntryList } from 'node:node:perf_hooks'`
          * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performanceobserverentrylist
          * @since v19.0.0
          */
@@ -908,7 +908,7 @@ declare module "perf_hooks" {
         } ? T
             : typeof _PerformanceObserverEntryList;
         /**
-         * `PerformanceResourceTiming` is a global reference for `require('node:perf_hooks').PerformanceResourceTiming`
+         * `PerformanceResourceTiming` is a global reference for `import { PerformanceResourceTiming } from 'node:node:perf_hooks'`
          * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performanceresourcetiming
          * @since v19.0.0
          */
@@ -918,7 +918,7 @@ declare module "perf_hooks" {
         } ? T
             : typeof _PerformanceResourceTiming;
         /**
-         * `performance` is a global reference for `require('node:perf_hooks').performance`
+         * `performance` is a global reference for `import { performance } from 'node:node:perf_hooks'`
          * @see https://nodejs.org/docs/latest-v20.x/api/globals.html#performance
          * @since v16.0.0
          */

node v20.16/punycode.d.ts

@@ -8,7 +8,7 @@
  * can be accessed using:
  *
  * ```js
- * const punycode = require('punycode');
+ * import punycode from 'node:punycode';
  * ```
  *
  * [Punycode](https://tools.ietf.org/html/rfc3492) is a character encoding scheme defined by RFC 3492 that is

node v20.16/querystring.d.ts

@@ -3,7 +3,7 @@
  * query strings. It can be accessed using:
  *
  * ```js
- * const querystring = require('node:querystring');
+ * import querystring from 'node:querystring';
  * ```
  *
  * `querystring` is more performant than `URLSearchParams` but is not a

node v20.16/readline/promises.d.ts

@@ -115,7 +115,7 @@ declare module "readline/promises" {
      * The `readlinePromises.createInterface()` method creates a new `readlinePromises.Interface` instance.
      *
      * ```js
-     * const readlinePromises = require('node:readline/promises');
+     * import readlinePromises from 'node:readline/promises';
      * const rl = readlinePromises.createInterface({
      *   input: process.stdin,
      *   output: process.stdout,

node v20.16/readline.d.ts

@@ -342,7 +342,7 @@ declare module "readline" {
      * The `readline.createInterface()` method creates a new `readline.Interface` instance.
      *
      * ```js
-     * const readline = require('node:readline');
+     * import readline from 'node:readline';
      * const rl = readline.createInterface({
      *   input: process.stdin,
      *   output: process.stdout,
@@ -398,7 +398,7 @@ declare module "readline" {
      * implement a small command-line interface:
      *
      * ```js
-     * const readline = require('node:readline');
+     * import readline from 'node:readline';
      * const rl = readline.createInterface({
      *   input: process.stdin,
      *   output: process.stdout,
@@ -430,8 +430,8 @@ declare module "readline" {
      * well as a `for await...of` loop:
      *
      * ```js
-     * const fs = require('node:fs');
-     * const readline = require('node:readline');
+     * import fs from 'node:fs';
+     * import readline from 'node:readline';
      *
      * async function processLineByLine() {
      *   const fileStream = fs.createReadStream('input.txt');
@@ -455,8 +455,8 @@ declare module "readline" {
      * Alternatively, one could use the `'line'` event:
      *
      * ```js
-     * const fs = require('node:fs');
-     * const readline = require('node:readline');
+     * import fs from 'node:fs';
+     * import readline from 'node:readline';
      *
      * const rl = readline.createInterface({
      *   input: fs.createReadStream('sample.txt'),
@@ -471,9 +471,9 @@ declare module "readline" {
      * Currently, `for await...of` loop can be a bit slower. If `async` / `await` flow and speed are both essential, a mixed approach can be applied:
      *
      * ```js
-     * const { once } = require('node:events');
-     * const { createReadStream } = require('node:fs');
-     * const { createInterface } = require('node:readline');
+     * import { once } from 'node:events';
+     * import { createReadStream } from 'node:fs';
+     * import { createInterface } from 'node:readline';
      *
      * (async function processLineByLine() {
      *   try {

node v20.16/repl.d.ts

@@ -4,7 +4,7 @@
  * applications. It can be accessed using:
  *
  * ```js
- * const repl = require('node:repl');
+ * import repl from 'node:repl';
  * ```
  * @see [source](https://github.com/nodejs/node/blob/v20.13.1/lib/repl.js)
  */
@@ -130,7 +130,7 @@ declare module "repl" {
      * or directly using the JavaScript `new` keyword.
      *
      * ```js
-     * const repl = require('node:repl');
+     * import repl from 'node:repl';
      *
      * const options = { useColors: true };
      *
@@ -257,7 +257,7 @@ declare module "repl" {
          * The following example shows two new commands added to the REPL instance:
          *
          * ```js
-         * const repl = require('node:repl');
+         * import repl from 'node:repl';
          *
          * const replServer = repl.start({ prompt: '> ' });
          * replServer.defineCommand('sayhello', {
@@ -407,7 +407,7 @@ declare module "repl" {
      * If `options` is a string, then it specifies the input prompt:
      *
      * ```js
-     * const repl = require('node:repl');
+     * import repl from 'node:repl';
      *
      * // a Unix style prompt
      * repl.start('$ ');

node v20.16/stream.d.ts

@@ -10,7 +10,7 @@
  * To access the `node:stream` module:
  *
  * ```js
- * const stream = require('node:stream');
+ * import stream from 'node:stream';
  * ```
  *
  * The `node:stream` module is useful for creating new types of stream instances.
@@ -303,7 +303,7 @@ declare module "stream" {
          * the method does nothing.
          *
          * ```js
-         * const fs = require('node:fs');
+         * import fs from 'node:fs';
          * const readable = getReadableStreamSomehow();
          * const writable = fs.createWriteStream('file.txt');
          * // All the data from readable goes into 'file.txt',
@@ -341,7 +341,7 @@ declare module "stream" {
          * // Pull off a header delimited by \n\n.
          * // Use unshift() if we get too much.
          * // Call the callback with (error, header, stream).
-         * const { StringDecoder } = require('node:string_decoder');
+         * import { StringDecoder } from 'node:string_decoder';
          * function parseHeader(stream, callback) {
          *   stream.on('error', callback);
          *   stream.on('readable', onReadable);
@@ -399,8 +399,8 @@ declare module "stream" {
          * libraries.
          *
          * ```js
-         * const { OldReader } = require('./old-api-module.js');
-         * const { Readable } = require('node:stream');
+         * import { OldReader } from './old-api-module.js';
+         * import { Readable } from 'node:stream';
          * const oreader = new OldReader();
          * const myReader = new Readable().wrap(oreader);
          *
@@ -806,7 +806,7 @@ declare module "stream" {
          *
          * ```js
          * // Write 'hello, ' and then end with 'world!'.
-         * const fs = require('node:fs');
+         * import fs from 'node:fs';
          * const file = fs.createWriteStream('example.txt');
          * file.write('hello, ');
          * file.end('world!');
@@ -1304,7 +1304,7 @@ declare module "stream" {
          * stream, and `controller.error(new AbortError())` for webstreams.
          *
          * ```js
-         * const fs = require('node:fs');
+         * import fs from 'node:fs';
          *
          * const controller = new AbortController();
          * const read = addAbortSignal(
@@ -1398,8 +1398,8 @@ declare module "stream" {
          * or has experienced an error or a premature close event.
          *
          * ```js
-         * const { finished } = require('node:stream');
-         * const fs = require('node:fs');
+         * import { finished } from 'node:stream';
+         * import fs from 'node:fs';
          *
          * const rs = fs.createReadStream('archive.tar');
          *
@@ -1482,9 +1482,9 @@ declare module "stream" {
          * properly cleaning up and provide a callback when the pipeline is complete.
          *
          * ```js
-         * const { pipeline } = require('node:stream');
-         * const fs = require('node:fs');
-         * const zlib = require('node:zlib');
+         * import { pipeline } from 'node:stream';
+         * import fs from 'node:fs';
+         * import zlib from 'node:zlib';
          *
          * // Use the pipeline API to easily pipe a series of streams
          * // together and get notified when the pipeline is fully done.
@@ -1524,9 +1524,9 @@ declare module "stream" {
          * See the example below:
          *
          * ```js
-         * const fs = require('node:fs');
-         * const http = require('node:http');
-         * const { pipeline } = require('node:stream');
+         * import fs from 'node:fs';
+         * import http from 'node:http';
+         * import { pipeline } from 'node:stream';
          *
          * const server = http.createServer((req, res) => {
          *   const fileStream = fs.createReadStream('./fileNotExist.txt');

node v20.16/string_decoder.d.ts

@@ -4,13 +4,13 @@
  * characters. It can be accessed using:
  *
  * ```js
- * const { StringDecoder } = require('node:string_decoder');
+ * import { StringDecoder } from 'node:string_decoder';
  * ```
  *
  * The following example shows the basic use of the `StringDecoder` class.
  *
  * ```js
- * const { StringDecoder } = require('node:string_decoder');
+ * import { StringDecoder } from 'node:string_decoder';
  * const decoder = new StringDecoder('utf8');
  *
  * const cent = Buffer.from([0xC2, 0xA2]);
@@ -29,7 +29,7 @@
  * symbol (`€`) are written over three separate operations:
  *
  * ```js
- * const { StringDecoder } = require('node:string_decoder');
+ * import { StringDecoder } from 'node:string_decoder';
  * const decoder = new StringDecoder('utf8');
  *
  * decoder.write(Buffer.from([0xE2]));

node v20.16/timers/promises.d.ts

@@ -1,6 +1,6 @@
 /**
  * The `timers/promises` API provides an alternative set of timer functions
- * that return `Promise` objects. The API is accessible via `require('node:timers/promises')`.
+ * that return `Promise` objects. The API is accessible via `import timersPromises from 'node:timers/promises'`.
  *
  * ```js
  * import {

node v20.16/timers.d.ts

@@ -1,7 +1,7 @@
 /**
  * The `timer` module exposes a global API for scheduling functions to
  * be called at some future period of time. Because the timer functions are
- * globals, there is no need to call `require('node:timers')` to use the API.
+ * globals, there is no need to import `node:timers` to use the API.
  *
  * The timer functions within Node.js implement a similar API as the timers API
  * provided by Web Browsers but use a different internal implementation that is

node v20.16/tls.d.ts

@@ -4,7 +4,7 @@
  * The module can be accessed using:
  *
  * ```js
- * const tls = require('node:tls');
+ * import tls from 'node:tls';
  * ```
  * @see [source](https://github.com/nodejs/node/blob/v20.13.1/lib/tls.js)
  */
@@ -1000,8 +1000,8 @@ declare module "tls" {
      * The following illustrates a simple echo server:
      *
      * ```js
-     * const tls = require('node:tls');
-     * const fs = require('node:fs');
+     * import tls from 'node:tls';
+     * import fs from 'node:fs';
      *
      * const options = {
      *   key: fs.readFileSync('server-key.pem'),
@@ -1046,8 +1046,8 @@ declare module "tls" {
      *
      * ```js
      * // Assumes an echo server that is listening on port 8000.
-     * const tls = require('node:tls');
-     * const fs = require('node:fs');
+     * import tls from 'node:tls';
+     * import fs from 'node:fs';
      *
      * const options = {
      *   // Necessary only if the server requires client certificate authentication.

node v20.16/trace_events.d.ts

@@ -53,7 +53,7 @@
  * Alternatively, trace events may be enabled using the `node:trace_events` module:
  *
  * ```js
- * const trace_events = require('node:trace_events');
+ * import trace_events from 'node:trace_events';
  * const tracing = trace_events.createTracing({ categories: ['node.perf'] });
  * tracing.enable();  // Enable trace event capture for the 'node.perf' category
  *
@@ -118,7 +118,7 @@ declare module "trace_events" {
          * will be disabled.
          *
          * ```js
-         * const trace_events = require('node:trace_events');
+         * import trace_events from 'node:trace_events';
          * const t1 = trace_events.createTracing({ categories: ['node', 'v8'] });
          * const t2 = trace_events.createTracing({ categories: ['node.perf', 'node'] });
          * t1.enable();
@@ -159,7 +159,7 @@ declare module "trace_events" {
      * Creates and returns a `Tracing` object for the given set of `categories`.
      *
      * ```js
-     * const trace_events = require('node:trace_events');
+     * import trace_events from 'node:trace_events';
      * const categories = ['node.perf', 'node.async_hooks'];
      * const tracing = trace_events.createTracing({ categories });
      * tracing.enable();
@@ -178,7 +178,7 @@ declare module "trace_events" {
      * Given the file `test.js` below, the command `node --trace-event-categories node.perf test.js` will print `'node.async_hooks,node.perf'` to the console.
      *
      * ```js
-     * const trace_events = require('node:trace_events');
+     * import trace_events from 'node:trace_events';
      * const t1 = trace_events.createTracing({ categories: ['node.async_hooks'] });
      * const t2 = trace_events.createTracing({ categories: ['node.perf'] });
      * const t3 = trace_events.createTracing({ categories: ['v8'] });