@types/node 22.7.1 → 22.7.2

node/stream/web.d.ts

@@ -418,7 +418,7 @@ declare module "stream/web" {
     global {
         interface ByteLengthQueuingStrategy extends _ByteLengthQueuingStrategy {}
         /**
-         * `ByteLengthQueuingStrategy` class is a global reference for `require('stream/web').ByteLengthQueuingStrategy`.
+         * `ByteLengthQueuingStrategy` class is a global reference for `import { ByteLengthQueuingStrategy } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-bytelengthqueuingstrategy
          * @since v18.0.0
          */
@@ -428,7 +428,7 @@ declare module "stream/web" {
 
         interface CompressionStream extends _CompressionStream {}
         /**
-         * `CompressionStream` class is a global reference for `require('stream/web').CompressionStream`.
+         * `CompressionStream` class is a global reference for `import { CompressionStream } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-compressionstream
          * @since v18.0.0
          */
@@ -448,7 +448,7 @@ declare module "stream/web" {
 
         interface CountQueuingStrategy extends _CountQueuingStrategy {}
         /**
-         * `CountQueuingStrategy` class is a global reference for `require('stream/web').CountQueuingStrategy`.
+         * `CountQueuingStrategy` class is a global reference for `import { CountQueuingStrategy } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-countqueuingstrategy
          * @since v18.0.0
          */
@@ -457,7 +457,7 @@ declare module "stream/web" {
 
         interface DecompressionStream extends _DecompressionStream {}
         /**
-         * `DecompressionStream` class is a global reference for `require('stream/web').DecompressionStream`.
+         * `DecompressionStream` class is a global reference for `import { DecompressionStream } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-decompressionstream
          * @since v18.0.0
          */
@@ -477,7 +477,7 @@ declare module "stream/web" {
 
         interface ReadableByteStreamController extends _ReadableByteStreamController {}
         /**
-         * `ReadableByteStreamController` class is a global reference for `require('stream/web').ReadableByteStreamController`.
+         * `ReadableByteStreamController` class is a global reference for `import { ReadableByteStreamController } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-readablebytestreamcontroller
          * @since v18.0.0
          */
@@ -487,7 +487,7 @@ declare module "stream/web" {
 
         interface ReadableStream<R = any> extends _ReadableStream<R> {}
         /**
-         * `ReadableStream` class is a global reference for `require('stream/web').ReadableStream`.
+         * `ReadableStream` class is a global reference for `import { ReadableStream } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-readablestream
          * @since v18.0.0
          */
@@ -496,7 +496,7 @@ declare module "stream/web" {
 
         interface ReadableStreamBYOBReader extends _ReadableStreamBYOBReader {}
         /**
-         * `ReadableStreamBYOBReader` class is a global reference for `require('stream/web').ReadableStreamBYOBReader`.
+         * `ReadableStreamBYOBReader` class is a global reference for `import { ReadableStreamBYOBReader } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-readablestreambyobreader
          * @since v18.0.0
          */
@@ -506,7 +506,7 @@ declare module "stream/web" {
 
         interface ReadableStreamBYOBRequest extends _ReadableStreamBYOBRequest {}
         /**
-         * `ReadableStreamBYOBRequest` class is a global reference for `require('stream/web').ReadableStreamBYOBRequest`.
+         * `ReadableStreamBYOBRequest` class is a global reference for `import { ReadableStreamBYOBRequest } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-readablestreambyobrequest
          * @since v18.0.0
          */
@@ -516,7 +516,7 @@ declare module "stream/web" {
 
         interface ReadableStreamDefaultController<R = any> extends _ReadableStreamDefaultController<R> {}
         /**
-         * `ReadableStreamDefaultController` class is a global reference for `require('stream/web').ReadableStreamDefaultController`.
+         * `ReadableStreamDefaultController` class is a global reference for `import { ReadableStreamDefaultController } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-readablestreamdefaultcontroller
          * @since v18.0.0
          */
@@ -526,7 +526,7 @@ declare module "stream/web" {
 
         interface ReadableStreamDefaultReader<R = any> extends _ReadableStreamDefaultReader<R> {}
         /**
-         * `ReadableStreamDefaultReader` class is a global reference for `require('stream/web').ReadableStreamDefaultReader`.
+         * `ReadableStreamDefaultReader` class is a global reference for `import { ReadableStreamDefaultReader } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-readablestreamdefaultreader
          * @since v18.0.0
          */
@@ -536,7 +536,7 @@ declare module "stream/web" {
 
         interface TextDecoderStream extends _TextDecoderStream {}
         /**
-         * `TextDecoderStream` class is a global reference for `require('stream/web').TextDecoderStream`.
+         * `TextDecoderStream` class is a global reference for `import { TextDecoderStream } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-textdecoderstream
          * @since v18.0.0
          */
@@ -545,7 +545,7 @@ declare module "stream/web" {
 
         interface TextEncoderStream extends _TextEncoderStream {}
         /**
-         * `TextEncoderStream` class is a global reference for `require('stream/web').TextEncoderStream`.
+         * `TextEncoderStream` class is a global reference for `import { TextEncoderStream } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-textencoderstream
          * @since v18.0.0
          */
@@ -554,7 +554,7 @@ declare module "stream/web" {
 
         interface TransformStream<I = any, O = any> extends _TransformStream<I, O> {}
         /**
-         * `TransformStream` class is a global reference for `require('stream/web').TransformStream`.
+         * `TransformStream` class is a global reference for `import { TransformStream } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-transformstream
          * @since v18.0.0
          */
@@ -563,7 +563,7 @@ declare module "stream/web" {
 
         interface TransformStreamDefaultController<O = any> extends _TransformStreamDefaultController<O> {}
         /**
-         * `TransformStreamDefaultController` class is a global reference for `require('stream/web').TransformStreamDefaultController`.
+         * `TransformStreamDefaultController` class is a global reference for `import { TransformStreamDefaultController } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-transformstreamdefaultcontroller
          * @since v18.0.0
          */
@@ -573,7 +573,7 @@ declare module "stream/web" {
 
         interface WritableStream<W = any> extends _WritableStream<W> {}
         /**
-         * `WritableStream` class is a global reference for `require('stream/web').WritableStream`.
+         * `WritableStream` class is a global reference for `import { WritableStream } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-writablestream
          * @since v18.0.0
          */
@@ -582,7 +582,7 @@ declare module "stream/web" {
 
         interface WritableStreamDefaultController extends _WritableStreamDefaultController {}
         /**
-         * `WritableStreamDefaultController` class is a global reference for `require('stream/web').WritableStreamDefaultController`.
+         * `WritableStreamDefaultController` class is a global reference for `import { WritableStreamDefaultController } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-writablestreamdefaultcontroller
          * @since v18.0.0
          */
@@ -592,7 +592,7 @@ declare module "stream/web" {
 
         interface WritableStreamDefaultWriter<W = any> extends _WritableStreamDefaultWriter<W> {}
         /**
-         * `WritableStreamDefaultWriter` class is a global reference for `require('stream/web').WritableStreamDefaultWriter`.
+         * `WritableStreamDefaultWriter` class is a global reference for `import { WritableStreamDefaultWriter } from 'node:stream/web'`.
          * https://nodejs.org/api/globals.html#class-writablestreamdefaultwriter
          * @since v18.0.0
          */

node/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!');
@@ -1323,7 +1323,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(
@@ -1417,8 +1417,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');
          *
@@ -1501,9 +1501,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.
@@ -1543,9 +1543,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/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/test.d.ts

@@ -10,7 +10,7 @@
  * work:
  *
  * ```js
- * import test from 'test';
+ * import test from 'node:test';
  * ```
  *
  * Tests created via the `test` module consist of a single function that is
@@ -2029,7 +2029,7 @@ interface TestStdout {
  * work:
  *
  * ```js
- * import test from 'test/reporters';
+ * import test from 'node:test/reporters';
  * ```
  * @since v19.9.0
  * @see [source](https://github.com/nodejs/node/blob/v22.x/lib/test/reporters.js)

node/timers/promises.d.ts

@@ -1,13 +1,13 @@
 /**
  * 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 {
  *   setTimeout,
  *   setImmediate,
  *   setInterval,
- * } from 'timers/promises';
+ * } from 'node:timers/promises';
  * ```
  * @since v15.0.0
  */
@@ -17,7 +17,7 @@ declare module "timers/promises" {
      * ```js
      * import {
      *   setTimeout,
-     * } from 'timers/promises';
+     * } from 'node:timers/promises';
      *
      * const res = await setTimeout(100, 'result');
      *
@@ -32,7 +32,7 @@ declare module "timers/promises" {
      * ```js
      * import {
      *   setImmediate,
-     * } from 'timers/promises';
+     * } from 'node:timers/promises';
      *
      * const res = await setImmediate('result');
      *
@@ -50,7 +50,7 @@ declare module "timers/promises" {
      * ```js
      * import {
      *   setInterval,
-     * } from 'timers/promises';
+     * } from 'node:timers/promises';
      *
      * const interval = 100;
      * for await (const startTime of setInterval(interval, Date.now())) {

node/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/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/v22.x/lib/tls.js)
  */
@@ -1003,8 +1003,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'),
@@ -1049,8 +1049,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/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'] });

node/tty.d.ts

@@ -3,7 +3,7 @@
  * directly. However, it can be accessed using:
  *
  * ```js
- * const tty = require('node:tty');
+ * import tty from 'node:tty';
  * ```
  *
  * When Node.js detects that it is being run with a text terminal ("TTY")

node/url.d.ts

@@ -93,7 +93,7 @@ declare module "url" {
      * The `url.format()` method returns a formatted URL string derived from `urlObject`.
      *
      * ```js
-     * const url = require('node:url');
+     * import url from 'node:url';
      * url.format({
      *   protocol: 'https',
      *   hostname: 'example.com',
@@ -157,7 +157,7 @@ declare module "url" {
      * The `url.format()` method returns a formatted URL string derived from `urlObject`.
      *
      * ```js
-     * const url = require('node:url');
+     * import url from 'node:url';
      * url.format({
      *   protocol: 'https',
      *   hostname: 'example.com',
@@ -222,7 +222,7 @@ declare module "url" {
      * manner similar to that of a web browser resolving an anchor tag.
      *
      * ```js
-     * const url = require('node:url');
+     * import url from 'node:url';
      * url.resolve('/one/two/three', 'four');         // '/one/two/four'
      * url.resolve('http://example.com/', '/one');    // 'http://example.com/one'
      * url.resolve('http://example.com/one', '/two'); // 'http://example.com/two'
@@ -400,10 +400,10 @@ declare module "url" {
          * Creates a `'blob:nodedata:...'` URL string that represents the given `Blob` object and can be used to retrieve the `Blob` later.
          *
          * ```js
-         * const {
+         * import {
          *   Blob,
          *   resolveObjectURL,
-         * } = require('node:buffer');
+         * } from 'node:buffer';
          *
          * const blob = new Blob(['hello']);
          * const id = URL.createObjectURL(blob);
@@ -943,7 +943,7 @@ declare module "url" {
             URLSearchParams: typeof _URLSearchParams;
         }
         /**
-         * `URL` class is a global reference for `require('url').URL`
+         * `URL` class is a global reference for `import { URL } from 'url'`
          * https://nodejs.org/api/url.html#the-whatwg-url-api
          * @since v10.0.0
          */
@@ -953,7 +953,7 @@ declare module "url" {
         } ? T
             : typeof _URL;
         /**
-         * `URLSearchParams` class is a global reference for `require('url').URLSearchParams`
+         * `URLSearchParams` class is a global reference for `import { URLSearchParams } from 'node:url'`
          * https://nodejs.org/api/url.html#class-urlsearchparams
          * @since v10.0.0
          */