@types/node 17.0.44 → 17.0.45

node/README.md → node v17.0/README.md

@@ -5,12 +5,12 @@
 This package contains type definitions for Node.js (https://nodejs.org/).
 
 # Details
-Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
+Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node/v17.
 
 ### Additional Details
- * Last updated: Wed, 15 Jun 2022 15:01:35 GMT
+ * Last updated: Wed, 15 Jun 2022 23:01:35 GMT
  * Dependencies: none
  * Global values: `AbortController`, `AbortSignal`, `__dirname`, `__filename`, `console`, `exports`, `gc`, `global`, `module`, `process`, `require`, `structuredClone`
 
 # Credits
-These definitions were written by [Microsoft TypeScript](https://github.com/Microsoft), [DefinitelyTyped](https://github.com/DefinitelyTyped), [Alberto Schiabel](https://github.com/jkomyno), [Alvis HT Tang](https://github.com/alvis), [Andrew Makarov](https://github.com/r3nya), [Benjamin Toueg](https://github.com/btoueg), [Chigozirim C.](https://github.com/smac89), [David Junger](https://github.com/touffy), [Deividas Bakanas](https://github.com/DeividasBakanas), [Eugene Y. Q. Shen](https://github.com/eyqs), [Hannes Magnusson](https://github.com/Hannes-Magnusson-CK), [Huw](https://github.com/hoo29), [Kelvin Jin](https://github.com/kjin), [Klaus Meinhardt](https://github.com/ajafff), [Lishude](https://github.com/islishude), [Mariusz Wiktorczyk](https://github.com/mwiktorczyk), [Mohsen Azimi](https://github.com/mohsen1), [Nicolas Even](https://github.com/n-e), [Nikita Galkin](https://github.com/galkin), [Parambir Singh](https://github.com/parambirs), [Sebastian Silbermann](https://github.com/eps1lon), [Simon Schick](https://github.com/SimonSchick), [Thomas den Hollander](https://github.com/ThomasdenH), [Wilco Bakker](https://github.com/WilcoBakker), [wwwy3y3](https://github.com/wwwy3y3), [Samuel Ainsworth](https://github.com/samuela), [Kyle Uehlein](https://github.com/kuehlein), [Thanik Bhongbhibhat](https://github.com/bhongy), [Marcin Kopacz](https://github.com/chyzwar), [Trivikram Kamat](https://github.com/trivikr), [Junxiao Shi](https://github.com/yoursunny), [Ilia Baryshnikov](https://github.com/qwelias), [ExE Boss](https://github.com/ExE-Boss), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Anna Henningsen](https://github.com/addaleax), [Victor Perin](https://github.com/victorperin), [Yongsheng Zhang](https://github.com/ZYSzys), [NodeJS Contributors](https://github.com/NodeJS), [Linus Unnebäck](https://github.com/LinusU), [wafuwafu13](https://github.com/wafuwafu13), and [Matteo Collina](https://github.com/mcollina).
+These definitions were written by [Microsoft TypeScript](https://github.com/Microsoft), [DefinitelyTyped](https://github.com/DefinitelyTyped), [Alberto Schiabel](https://github.com/jkomyno), [Alvis HT Tang](https://github.com/alvis), [Andrew Makarov](https://github.com/r3nya), [Benjamin Toueg](https://github.com/btoueg), [Chigozirim C.](https://github.com/smac89), [David Junger](https://github.com/touffy), [Deividas Bakanas](https://github.com/DeividasBakanas), [Eugene Y. Q. Shen](https://github.com/eyqs), [Hannes Magnusson](https://github.com/Hannes-Magnusson-CK), [Huw](https://github.com/hoo29), [Kelvin Jin](https://github.com/kjin), [Klaus Meinhardt](https://github.com/ajafff), [Lishude](https://github.com/islishude), [Mariusz Wiktorczyk](https://github.com/mwiktorczyk), [Mohsen Azimi](https://github.com/mohsen1), [Nicolas Even](https://github.com/n-e), [Nikita Galkin](https://github.com/galkin), [Parambir Singh](https://github.com/parambirs), [Sebastian Silbermann](https://github.com/eps1lon), [Simon Schick](https://github.com/SimonSchick), [Thomas den Hollander](https://github.com/ThomasdenH), [Wilco Bakker](https://github.com/WilcoBakker), [wwwy3y3](https://github.com/wwwy3y3), [Samuel Ainsworth](https://github.com/samuela), [Kyle Uehlein](https://github.com/kuehlein), [Thanik Bhongbhibhat](https://github.com/bhongy), [Marcin Kopacz](https://github.com/chyzwar), [Trivikram Kamat](https://github.com/trivikr), [Junxiao Shi](https://github.com/yoursunny), [Ilia Baryshnikov](https://github.com/qwelias), [ExE Boss](https://github.com/ExE-Boss), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Anna Henningsen](https://github.com/addaleax), [Victor Perin](https://github.com/victorperin), [Yongsheng Zhang](https://github.com/ZYSzys), [NodeJS Contributors](https://github.com/NodeJS), [Linus Unnebäck](https://github.com/LinusU), and [wafuwafu13](https://github.com/wafuwafu13).

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

@@ -1,7 +1,6 @@
 /**
  * **This module is pending deprecation.** Once a replacement API has been
- * finalized, this module will be fully deprecated. Most developers should
- * **not** have cause to use this module. Users who absolutely must have
+ * finalized, this module will be fully deprecated. Most developers should**not** have cause to use this module. Users who absolutely must have
  * the functionality that domains provide may rely on it for the time being
  * but should expect to have to migrate to a different solution
  * in the future.

node/fs/promises.d.ts → node v17.0/fs/promises.d.ts

@@ -11,7 +11,6 @@
 declare module 'fs/promises' {
     import { Abortable } from 'node:events';
     import { Stream } from 'node:stream';
-    import { ReadableStream } from 'node:stream/web';
     import {
         Stats,
         BigIntStats,
@@ -210,29 +209,6 @@ declare module 'fs/promises' {
          */
         read<T extends NodeJS.ArrayBufferView>(buffer: T, offset?: number | null, length?: number | null, position?: number | null): Promise<FileReadResult<T>>;
         read<T extends NodeJS.ArrayBufferView = Buffer>(options?: FileReadOptions<T>): Promise<FileReadResult<T>>;
-        /**
-         * Returns a `ReadableStream` that may be used to read the files data.
-         *
-         * An error will be thrown if this method is called more than once or is called after the `FileHandle` is closed
-         * or closing.
-         *
-         * ```js
-         * import { open } from 'node:fs/promises';
-         *
-         * const file = await open('./some/file/to/read');
-         *
-         * for await (const chunk of file.readableWebStream())
-         *   console.log(chunk);
-         *
-         * await file.close();
-         * ```
-         *
-         * While the `ReadableStream` will read the file to completion, it will not close the `FileHandle` automatically. User code must still call the `fileHandle.close()` method.
-         *
-         * @since v17.0.0
-         * @experimental
-         */
-        readableWebStream(): ReadableStream;
         /**
          * Asynchronously reads the entire contents of a file.
          *
@@ -511,7 +487,7 @@ declare module 'fs/promises' {
      * @param [mode=0o666] Sets the file mode (permission and sticky bits) if the file is created.
      * @return Fulfills with a {FileHandle} object.
      */
-    function open(path: PathLike, flags?: string | number, mode?: Mode): Promise<FileHandle>;
+    function open(path: PathLike, flags: string | number, mode?: Mode): Promise<FileHandle>;
     /**
      * Renames `oldPath` to `newPath`.
      * @since v10.0.0

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

@@ -1998,19 +1998,12 @@ declare module 'fs' {
      * @param [flags='r'] See `support of file system `flags``.
      * @param [mode=0o666]
      */
-    export function open(path: PathLike, flags: OpenMode | undefined, mode: Mode | undefined | null, callback: (err: NodeJS.ErrnoException | null, fd: number) => void): void;
-    /**
-     * Asynchronous open(2) - open and possibly create a file. If the file is created, its mode will be `0o666`.
-     * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * @param [flags='r'] See `support of file system `flags``.
-     */
-    export function open(path: PathLike, flags: OpenMode | undefined, callback: (err: NodeJS.ErrnoException | null, fd: number) => void): void;
+    export function open(path: PathLike, flags: OpenMode, mode: Mode | undefined | null, callback: (err: NodeJS.ErrnoException | null, fd: number) => void): void;
     /**
      * Asynchronous open(2) - open and possibly create a file. If the file is created, its mode will be `0o666`.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
      */
-    export function open(path: PathLike, callback: (err: NodeJS.ErrnoException | null, fd: number) => void): void;
-
+    export function open(path: PathLike, flags: OpenMode, callback: (err: NodeJS.ErrnoException | null, fd: number) => void): void;
     export namespace open {
         /**
          * Asynchronous open(2) - open and possibly create a file.

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

@@ -40,7 +40,6 @@
 //                 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
 
 /**

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

@@ -285,11 +285,6 @@ 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.

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

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

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

@@ -49,7 +49,6 @@ 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'
@@ -642,7 +641,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
@@ -669,7 +668,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).)
@@ -686,7 +685,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.
@@ -712,7 +711,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).)
@@ -729,7 +728,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
@@ -756,7 +755,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).)
@@ -773,7 +772,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
@@ -800,7 +799,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
@@ -818,7 +817,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
@@ -844,7 +843,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
@@ -1050,7 +1049,7 @@ declare module 'process' {
                  * ```
                  * @since v0.5.0
                  */
-                readonly arch: Architecture;
+                readonly arch: string;
                 /**
                  * The `process.platform` property returns a string identifying the operating
                  * system platform on which the Node.js process is running.

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

@@ -20,7 +20,6 @@ declare module 'stream' {
     import { EventEmitter, Abortable } from 'node:events';
     import * as streamPromises from 'node:stream/promises';
     import * as streamConsumers from 'node:stream/consumers';
-    import * as streamWeb from 'node:stream/web';
     class internal extends EventEmitter {
         pipe<T extends NodeJS.WritableStream>(
             destination: T,
@@ -53,23 +52,11 @@ declare module 'stream' {
              * A utility method for creating Readable Streams out of iterators.
              */
             static from(iterable: Iterable<any> | AsyncIterable<any>, options?: ReadableOptions): Readable;
-            /**
-             * A utility method for creating a `Readable` from a web `ReadableStream`.
-             * @since v17.0.0
-             * @experimental
-             */
-            static fromWeb(readableStream: streamWeb.ReadableStream, options?: Pick<ReadableOptions, 'encoding' | 'highWaterMark' | 'objectMode' | 'signal'>): Readable;
             /**
              * Returns whether the stream has been read from or cancelled.
              * @since v16.8.0
              */
             static isDisturbed(stream: Readable | NodeJS.ReadableStream): boolean;
-            /**
-             * A utility method for creating a web `ReadableStream` from a `Readable`.
-             * @since v17.0.0
-             * @experimental
-             */
-            static toWeb(streamReadable: Readable): streamWeb.ReadableStream;
             /**
              * Returns whether the stream was destroyed or errored before emitting `'end'`.
              * @since v16.8.0
@@ -1251,19 +1238,6 @@ declare module 'stream' {
             ref(): void;
             unref(): void;
         }
-
-        /**
-         * Returns whether the stream has encountered an error.
-         * @since v17.3.0
-         */
-        function isErrored(stream: Readable | Writable | NodeJS.ReadableStream | NodeJS.WritableStream): boolean;
-
-        /**
-         * Returns whether the stream is readable.
-         * @since v17.4.0
-         */
-        function isReadable(stream: Readable | NodeJS.ReadableStream): boolean;
-
         const promises: typeof streamPromises;
         const consumers: typeof streamConsumers;
     }

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

@@ -69,7 +69,7 @@ declare module 'timers' {
         namespace setTimeout {
             const __promisify__: typeof setTimeoutPromise;
         }
-        function clearTimeout(timeoutId: NodeJS.Timeout | string | number | undefined): void;
+        function clearTimeout(timeoutId: NodeJS.Timeout | undefined): void;
         function setInterval<TArgs extends any[]>(callback: (...args: TArgs) => void, ms?: number, ...args: TArgs): NodeJS.Timer;
         // util.promisify no rest args compability
         // tslint:disable-next-line void-return
@@ -77,7 +77,7 @@ declare module 'timers' {
         namespace setInterval {
             const __promisify__: typeof setIntervalPromise;
         }
-        function clearInterval(intervalId: NodeJS.Timeout | string | number | undefined): void;
+        function clearInterval(intervalId: NodeJS.Timeout | undefined): void;
         function setImmediate<TArgs extends any[]>(callback: (...args: TArgs) => void, ...args: TArgs): NodeJS.Immediate;
         // util.promisify no rest args compability
         // tslint:disable-next-line void-return

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

@@ -158,7 +158,7 @@ declare module 'tls' {
          * Always returns `true`. This may be used to distinguish TLS sockets from regular`net.Socket` instances.
          * @since v0.11.4
          */
-        encrypted: true;
+        encrypted: boolean;
         /**
          * String containing the selected ALPN protocol.
          * Before a handshake has completed, this value is always null.

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

@@ -59,12 +59,8 @@ declare module 'url' {
      * lenient, non-standard algorithm for parsing URL strings, security
      * issues can be introduced. Specifically, issues with [host name spoofing](https://hackerone.com/reports/678487) and
      * incorrect handling of usernames and passwords have been identified.
-     *
-     * Deprecation of this API has been shelved for now primarily due to the the
-     * inability of the [WHATWG API to parse relative URLs](https://github.com/nodejs/node/issues/12682#issuecomment-1154492373).
-     * [Discussions are ongoing](https://github.com/whatwg/url/issues/531) for the  best way to resolve this.
-     *
      * @since v0.1.25
+     * @deprecated Legacy: Use the WHATWG URL API instead.
      * @param urlString The URL string to parse.
      * @param [parseQueryString=false] If `true`, the `query` property will always be set to an object returned by the {@link querystring} module's `parse()` method. If `false`, the `query` property
      * on the returned URL object will be an unparsed, undecoded string.