cdk-common 2.1.12 → 2.1.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.jsii +57 -3
- package/API.md +54 -0
- package/lib/main.js +1 -1
- package/lib/managed-policies.d.ts +10 -1
- package/lib/managed-policies.js +10 -1
- package/node_modules/@types/concat-stream/node_modules/@types/node/README.md +1 -1
- package/node_modules/@types/concat-stream/node_modules/@types/node/assert/strict.d.ts +0 -46
- package/node_modules/@types/concat-stream/node_modules/@types/node/assert.d.ts +0 -5
- package/node_modules/@types/concat-stream/node_modules/@types/node/async_hooks.d.ts +18 -38
- package/node_modules/@types/concat-stream/node_modules/@types/node/buffer.buffer.d.ts +1 -1
- package/node_modules/@types/concat-stream/node_modules/@types/node/buffer.d.ts +0 -45
- package/node_modules/@types/concat-stream/node_modules/@types/node/child_process.d.ts +0 -67
- package/node_modules/@types/concat-stream/node_modules/@types/node/cluster.d.ts +0 -54
- package/node_modules/@types/concat-stream/node_modules/@types/node/console.d.ts +0 -58
- package/node_modules/@types/concat-stream/node_modules/@types/node/constants.d.ts +0 -6
- package/node_modules/@types/concat-stream/node_modules/@types/node/crypto.d.ts +0 -18
- package/node_modules/@types/concat-stream/node_modules/@types/node/dgram.d.ts +0 -27
- package/node_modules/@types/concat-stream/node_modules/@types/node/diagnostics_channel.d.ts +0 -24
- package/node_modules/@types/concat-stream/node_modules/@types/node/dns/promises.d.ts +0 -6
- package/node_modules/@types/concat-stream/node_modules/@types/node/dns.d.ts +0 -46
- package/node_modules/@types/concat-stream/node_modules/@types/node/domain.d.ts +0 -16
- package/node_modules/@types/concat-stream/node_modules/@types/node/events.d.ts +0 -36
- package/node_modules/@types/concat-stream/node_modules/@types/node/fs/promises.d.ts +0 -10
- package/node_modules/@types/concat-stream/node_modules/@types/node/fs.d.ts +0 -20
- package/node_modules/@types/concat-stream/node_modules/@types/node/http.d.ts +0 -41
- package/node_modules/@types/concat-stream/node_modules/@types/node/http2.d.ts +0 -10
- package/node_modules/@types/concat-stream/node_modules/@types/node/https.d.ts +0 -5
- package/node_modules/@types/concat-stream/node_modules/@types/node/inspector/promises.d.ts +0 -6
- package/node_modules/@types/concat-stream/node_modules/@types/node/inspector.d.ts +0 -5
- package/node_modules/@types/concat-stream/node_modules/@types/node/module.d.ts +0 -3
- package/node_modules/@types/concat-stream/node_modules/@types/node/net.d.ts +53 -16
- package/node_modules/@types/concat-stream/node_modules/@types/node/os.d.ts +0 -9
- package/node_modules/@types/concat-stream/node_modules/@types/node/package.json +4 -4
- package/node_modules/@types/concat-stream/node_modules/@types/node/path.d.ts +0 -9
- package/node_modules/@types/concat-stream/node_modules/@types/node/perf_hooks.d.ts +0 -31
- package/node_modules/@types/concat-stream/node_modules/@types/node/punycode.d.ts +0 -28
- package/node_modules/@types/concat-stream/node_modules/@types/node/querystring.d.ts +0 -13
- package/node_modules/@types/concat-stream/node_modules/@types/node/quic.d.ts +0 -13
- package/node_modules/@types/concat-stream/node_modules/@types/node/readline/promises.d.ts +0 -3
- package/node_modules/@types/concat-stream/node_modules/@types/node/readline.d.ts +0 -35
- package/node_modules/@types/concat-stream/node_modules/@types/node/repl.d.ts +0 -10
- package/node_modules/@types/concat-stream/node_modules/@types/node/sea.d.ts +0 -115
- package/node_modules/@types/concat-stream/node_modules/@types/node/sqlite.d.ts +0 -44
- package/node_modules/@types/concat-stream/node_modules/@types/node/stream/consumers.d.ts +81 -5
- package/node_modules/@types/concat-stream/node_modules/@types/node/stream/web.d.ts +3 -3
- package/node_modules/@types/concat-stream/node_modules/@types/node/stream.d.ts +27 -23
- package/node_modules/@types/concat-stream/node_modules/@types/node/string_decoder.d.ts +0 -40
- package/node_modules/@types/concat-stream/node_modules/@types/node/test/reporters.d.ts +0 -38
- package/node_modules/@types/concat-stream/node_modules/@types/node/test.d.ts +7 -80
- package/node_modules/@types/concat-stream/node_modules/@types/node/timers/promises.d.ts +0 -15
- package/node_modules/@types/concat-stream/node_modules/@types/node/timers.d.ts +0 -10
- package/node_modules/@types/concat-stream/node_modules/@types/node/tls.d.ts +6 -16
- package/node_modules/@types/concat-stream/node_modules/@types/node/trace_events.d.ts +0 -94
- package/node_modules/@types/concat-stream/node_modules/@types/node/ts5.6/buffer.buffer.d.ts +1 -1
- package/node_modules/@types/concat-stream/node_modules/@types/node/tty.d.ts +0 -25
- package/node_modules/@types/concat-stream/node_modules/@types/node/url.d.ts +0 -9
- package/node_modules/@types/concat-stream/node_modules/@types/node/util.d.ts +0 -10
- package/node_modules/@types/concat-stream/node_modules/@types/node/v8.d.ts +0 -8
- package/node_modules/@types/concat-stream/node_modules/@types/node/vm.d.ts +0 -38
- package/node_modules/@types/concat-stream/node_modules/@types/node/wasi.d.ts +0 -71
- package/node_modules/@types/concat-stream/node_modules/@types/node/worker_threads.d.ts +15 -61
- package/node_modules/@types/concat-stream/node_modules/@types/node/zlib.d.ts +0 -93
- package/node_modules/@types/concat-stream/node_modules/undici-types/cache-interceptor.d.ts +6 -0
- package/node_modules/@types/concat-stream/node_modules/undici-types/client.d.ts +10 -0
- package/node_modules/@types/concat-stream/node_modules/undici-types/package.json +1 -1
- package/node_modules/@types/form-data/node_modules/@types/node/README.md +1 -1
- package/node_modules/@types/form-data/node_modules/@types/node/assert/strict.d.ts +0 -46
- package/node_modules/@types/form-data/node_modules/@types/node/assert.d.ts +0 -5
- package/node_modules/@types/form-data/node_modules/@types/node/async_hooks.d.ts +18 -38
- package/node_modules/@types/form-data/node_modules/@types/node/buffer.buffer.d.ts +1 -1
- package/node_modules/@types/form-data/node_modules/@types/node/buffer.d.ts +0 -45
- package/node_modules/@types/form-data/node_modules/@types/node/child_process.d.ts +0 -67
- package/node_modules/@types/form-data/node_modules/@types/node/cluster.d.ts +0 -54
- package/node_modules/@types/form-data/node_modules/@types/node/console.d.ts +0 -58
- package/node_modules/@types/form-data/node_modules/@types/node/constants.d.ts +0 -6
- package/node_modules/@types/form-data/node_modules/@types/node/crypto.d.ts +0 -18
- package/node_modules/@types/form-data/node_modules/@types/node/dgram.d.ts +0 -27
- package/node_modules/@types/form-data/node_modules/@types/node/diagnostics_channel.d.ts +0 -24
- package/node_modules/@types/form-data/node_modules/@types/node/dns/promises.d.ts +0 -6
- package/node_modules/@types/form-data/node_modules/@types/node/dns.d.ts +0 -46
- package/node_modules/@types/form-data/node_modules/@types/node/domain.d.ts +0 -16
- package/node_modules/@types/form-data/node_modules/@types/node/events.d.ts +0 -36
- package/node_modules/@types/form-data/node_modules/@types/node/fs/promises.d.ts +0 -10
- package/node_modules/@types/form-data/node_modules/@types/node/fs.d.ts +0 -20
- package/node_modules/@types/form-data/node_modules/@types/node/http.d.ts +0 -41
- package/node_modules/@types/form-data/node_modules/@types/node/http2.d.ts +0 -10
- package/node_modules/@types/form-data/node_modules/@types/node/https.d.ts +0 -5
- package/node_modules/@types/form-data/node_modules/@types/node/inspector/promises.d.ts +0 -6
- package/node_modules/@types/form-data/node_modules/@types/node/inspector.d.ts +0 -5
- package/node_modules/@types/form-data/node_modules/@types/node/module.d.ts +0 -3
- package/node_modules/@types/form-data/node_modules/@types/node/net.d.ts +53 -16
- package/node_modules/@types/form-data/node_modules/@types/node/os.d.ts +0 -9
- package/node_modules/@types/form-data/node_modules/@types/node/package.json +4 -4
- package/node_modules/@types/form-data/node_modules/@types/node/path.d.ts +0 -9
- package/node_modules/@types/form-data/node_modules/@types/node/perf_hooks.d.ts +0 -31
- package/node_modules/@types/form-data/node_modules/@types/node/punycode.d.ts +0 -28
- package/node_modules/@types/form-data/node_modules/@types/node/querystring.d.ts +0 -13
- package/node_modules/@types/form-data/node_modules/@types/node/quic.d.ts +0 -13
- package/node_modules/@types/form-data/node_modules/@types/node/readline/promises.d.ts +0 -3
- package/node_modules/@types/form-data/node_modules/@types/node/readline.d.ts +0 -35
- package/node_modules/@types/form-data/node_modules/@types/node/repl.d.ts +0 -10
- package/node_modules/@types/form-data/node_modules/@types/node/sea.d.ts +0 -115
- package/node_modules/@types/form-data/node_modules/@types/node/sqlite.d.ts +0 -44
- package/node_modules/@types/form-data/node_modules/@types/node/stream/consumers.d.ts +81 -5
- package/node_modules/@types/form-data/node_modules/@types/node/stream/web.d.ts +3 -3
- package/node_modules/@types/form-data/node_modules/@types/node/stream.d.ts +27 -23
- package/node_modules/@types/form-data/node_modules/@types/node/string_decoder.d.ts +0 -40
- package/node_modules/@types/form-data/node_modules/@types/node/test/reporters.d.ts +0 -38
- package/node_modules/@types/form-data/node_modules/@types/node/test.d.ts +7 -80
- package/node_modules/@types/form-data/node_modules/@types/node/timers/promises.d.ts +0 -15
- package/node_modules/@types/form-data/node_modules/@types/node/timers.d.ts +0 -10
- package/node_modules/@types/form-data/node_modules/@types/node/tls.d.ts +6 -16
- package/node_modules/@types/form-data/node_modules/@types/node/trace_events.d.ts +0 -94
- package/node_modules/@types/form-data/node_modules/@types/node/ts5.6/buffer.buffer.d.ts +1 -1
- package/node_modules/@types/form-data/node_modules/@types/node/tty.d.ts +0 -25
- package/node_modules/@types/form-data/node_modules/@types/node/url.d.ts +0 -9
- package/node_modules/@types/form-data/node_modules/@types/node/util.d.ts +0 -10
- package/node_modules/@types/form-data/node_modules/@types/node/v8.d.ts +0 -8
- package/node_modules/@types/form-data/node_modules/@types/node/vm.d.ts +0 -38
- package/node_modules/@types/form-data/node_modules/@types/node/wasi.d.ts +0 -71
- package/node_modules/@types/form-data/node_modules/@types/node/worker_threads.d.ts +15 -61
- package/node_modules/@types/form-data/node_modules/@types/node/zlib.d.ts +0 -93
- package/node_modules/@types/form-data/node_modules/undici-types/cache-interceptor.d.ts +6 -0
- package/node_modules/@types/form-data/node_modules/undici-types/client.d.ts +10 -0
- package/node_modules/@types/form-data/node_modules/undici-types/package.json +1 -1
- package/node_modules/qs/CHANGELOG.md +6 -0
- package/node_modules/qs/dist/qs.js +16 -16
- package/node_modules/qs/lib/parse.js +2 -2
- package/node_modules/qs/package.json +3 -3
- package/node_modules/qs/test/parse.js +86 -0
- package/node_modules/qs/test/stringify.js +9 -0
- package/node_modules/qs/test/utils.js +31 -3
- package/node_modules/side-channel-list/CHANGELOG.md +25 -4
- package/node_modules/side-channel-list/index.js +1 -3
- package/node_modules/side-channel-list/package.json +8 -8
- package/node_modules/side-channel-list/test/index.js +50 -0
- package/package.json +27 -27
|
@@ -1,41 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The `node:vm` module enables compiling and running code within V8 Virtual
|
|
3
|
-
* Machine contexts.
|
|
4
|
-
*
|
|
5
|
-
* **The `node:vm` module is not a security**
|
|
6
|
-
* **mechanism. Do not use it to run untrusted code.**
|
|
7
|
-
*
|
|
8
|
-
* JavaScript code can be compiled and run immediately or
|
|
9
|
-
* compiled, saved, and run later.
|
|
10
|
-
*
|
|
11
|
-
* A common use case is to run the code in a different V8 Context. This means
|
|
12
|
-
* invoked code has a different global object than the invoking code.
|
|
13
|
-
*
|
|
14
|
-
* One can provide the context by `contextifying` an
|
|
15
|
-
* object. The invoked code treats any property in the context like a
|
|
16
|
-
* global variable. Any changes to global variables caused by the invoked
|
|
17
|
-
* code are reflected in the context object.
|
|
18
|
-
*
|
|
19
|
-
* ```js
|
|
20
|
-
* import vm from 'node:vm';
|
|
21
|
-
*
|
|
22
|
-
* const x = 1;
|
|
23
|
-
*
|
|
24
|
-
* const context = { x: 2 };
|
|
25
|
-
* vm.createContext(context); // Contextify the object.
|
|
26
|
-
*
|
|
27
|
-
* const code = 'x += 40; var y = 17;';
|
|
28
|
-
* // `x` and `y` are global variables in the context.
|
|
29
|
-
* // Initially, x has the value 2 because that is the value of context.x.
|
|
30
|
-
* vm.runInContext(code, context);
|
|
31
|
-
*
|
|
32
|
-
* console.log(context.x); // 42
|
|
33
|
-
* console.log(context.y); // 17
|
|
34
|
-
*
|
|
35
|
-
* console.log(x); // 1; y is not defined.
|
|
36
|
-
* ```
|
|
37
|
-
* @see [source](https://github.com/nodejs/node/blob/v25.x/lib/vm.js)
|
|
38
|
-
*/
|
|
39
1
|
declare module "node:vm" {
|
|
40
2
|
import { NonSharedBuffer } from "node:buffer";
|
|
41
3
|
import { ImportAttributes, ImportPhase } from "node:module";
|
|
@@ -1,74 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* **The `node:wasi` module does not currently provide the**
|
|
3
|
-
* **comprehensive file system security properties provided by some WASI runtimes.**
|
|
4
|
-
* **Full support for secure file system sandboxing may or may not be implemented in**
|
|
5
|
-
* **future. In the mean time, do not rely on it to run untrusted code.**
|
|
6
|
-
*
|
|
7
|
-
* The WASI API provides an implementation of the [WebAssembly System Interface](https://wasi.dev/) specification. WASI gives WebAssembly applications access to the underlying
|
|
8
|
-
* operating system via a collection of POSIX-like functions.
|
|
9
|
-
*
|
|
10
|
-
* ```js
|
|
11
|
-
* import { readFile } from 'node:fs/promises';
|
|
12
|
-
* import { WASI } from 'node:wasi';
|
|
13
|
-
* import { argv, env } from 'node:process';
|
|
14
|
-
*
|
|
15
|
-
* const wasi = new WASI({
|
|
16
|
-
* version: 'preview1',
|
|
17
|
-
* args: argv,
|
|
18
|
-
* env,
|
|
19
|
-
* preopens: {
|
|
20
|
-
* '/local': '/some/real/path/that/wasm/can/access',
|
|
21
|
-
* },
|
|
22
|
-
* });
|
|
23
|
-
*
|
|
24
|
-
* const wasm = await WebAssembly.compile(
|
|
25
|
-
* await readFile(new URL('./demo.wasm', import.meta.url)),
|
|
26
|
-
* );
|
|
27
|
-
* const instance = await WebAssembly.instantiate(wasm, wasi.getImportObject());
|
|
28
|
-
*
|
|
29
|
-
* wasi.start(instance);
|
|
30
|
-
* ```
|
|
31
|
-
*
|
|
32
|
-
* To run the above example, create a new WebAssembly text format file named `demo.wat`:
|
|
33
|
-
*
|
|
34
|
-
* ```text
|
|
35
|
-
* (module
|
|
36
|
-
* ;; Import the required fd_write WASI function which will write the given io vectors to stdout
|
|
37
|
-
* ;; The function signature for fd_write is:
|
|
38
|
-
* ;; (File Descriptor, *iovs, iovs_len, nwritten) -> Returns number of bytes written
|
|
39
|
-
* (import "wasi_snapshot_preview1" "fd_write" (func $fd_write (param i32 i32 i32 i32) (result i32)))
|
|
40
|
-
*
|
|
41
|
-
* (memory 1)
|
|
42
|
-
* (export "memory" (memory 0))
|
|
43
|
-
*
|
|
44
|
-
* ;; Write 'hello world\n' to memory at an offset of 8 bytes
|
|
45
|
-
* ;; Note the trailing newline which is required for the text to appear
|
|
46
|
-
* (data (i32.const 8) "hello world\n")
|
|
47
|
-
*
|
|
48
|
-
* (func $main (export "_start")
|
|
49
|
-
* ;; Creating a new io vector within linear memory
|
|
50
|
-
* (i32.store (i32.const 0) (i32.const 8)) ;; iov.iov_base - This is a pointer to the start of the 'hello world\n' string
|
|
51
|
-
* (i32.store (i32.const 4) (i32.const 12)) ;; iov.iov_len - The length of the 'hello world\n' string
|
|
52
|
-
*
|
|
53
|
-
* (call $fd_write
|
|
54
|
-
* (i32.const 1) ;; file_descriptor - 1 for stdout
|
|
55
|
-
* (i32.const 0) ;; *iovs - The pointer to the iov array, which is stored at memory location 0
|
|
56
|
-
* (i32.const 1) ;; iovs_len - We're printing 1 string stored in an iov - so one.
|
|
57
|
-
* (i32.const 20) ;; nwritten - A place in memory to store the number of bytes written
|
|
58
|
-
* )
|
|
59
|
-
* drop ;; Discard the number of bytes written from the top of the stack
|
|
60
|
-
* )
|
|
61
|
-
* )
|
|
62
|
-
* ```
|
|
63
|
-
*
|
|
64
|
-
* Use [wabt](https://github.com/WebAssembly/wabt) to compile `.wat` to `.wasm`
|
|
65
|
-
*
|
|
66
|
-
* ```bash
|
|
67
|
-
* wat2wasm demo.wat
|
|
68
|
-
* ```
|
|
69
|
-
* @experimental
|
|
70
|
-
* @see [source](https://github.com/nodejs/node/blob/v25.x/lib/wasi.js)
|
|
71
|
-
*/
|
|
72
1
|
declare module "node:wasi" {
|
|
73
2
|
interface WASIOptions {
|
|
74
3
|
/**
|
|
@@ -1,59 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The `node:worker_threads` module enables the use of threads that execute
|
|
3
|
-
* JavaScript in parallel. To access it:
|
|
4
|
-
*
|
|
5
|
-
* ```js
|
|
6
|
-
* import worker from 'node:worker_threads';
|
|
7
|
-
* ```
|
|
8
|
-
*
|
|
9
|
-
* Workers (threads) are useful for performing CPU-intensive JavaScript operations.
|
|
10
|
-
* They do not help much with I/O-intensive work. The Node.js built-in
|
|
11
|
-
* asynchronous I/O operations are more efficient than Workers can be.
|
|
12
|
-
*
|
|
13
|
-
* Unlike `child_process` or `cluster`, `worker_threads` can share memory. They do
|
|
14
|
-
* so by transferring `ArrayBuffer` instances or sharing `SharedArrayBuffer` instances.
|
|
15
|
-
*
|
|
16
|
-
* ```js
|
|
17
|
-
* import {
|
|
18
|
-
* Worker,
|
|
19
|
-
* isMainThread,
|
|
20
|
-
* parentPort,
|
|
21
|
-
* workerData,
|
|
22
|
-
* } from 'node:worker_threads';
|
|
23
|
-
*
|
|
24
|
-
* if (!isMainThread) {
|
|
25
|
-
* const { parse } = await import('some-js-parsing-library');
|
|
26
|
-
* const script = workerData;
|
|
27
|
-
* parentPort.postMessage(parse(script));
|
|
28
|
-
* }
|
|
29
|
-
*
|
|
30
|
-
* export default function parseJSAsync(script) {
|
|
31
|
-
* return new Promise((resolve, reject) => {
|
|
32
|
-
* const worker = new Worker(new URL(import.meta.url), {
|
|
33
|
-
* workerData: script,
|
|
34
|
-
* });
|
|
35
|
-
* worker.on('message', resolve);
|
|
36
|
-
* worker.once('error', reject);
|
|
37
|
-
* worker.once('exit', (code) => {
|
|
38
|
-
* if (code !== 0)
|
|
39
|
-
* reject(new Error(`Worker stopped with exit code ${code}`));
|
|
40
|
-
* });
|
|
41
|
-
* });
|
|
42
|
-
* };
|
|
43
|
-
* ```
|
|
44
|
-
*
|
|
45
|
-
* The above example spawns a Worker thread for each `parseJSAsync()` call. In
|
|
46
|
-
* practice, use a pool of Workers for these kinds of tasks. Otherwise, the
|
|
47
|
-
* overhead of creating Workers would likely exceed their benefit.
|
|
48
|
-
*
|
|
49
|
-
* When implementing a worker pool, use the `AsyncResource` API to inform
|
|
50
|
-
* diagnostic tools (e.g. to provide asynchronous stack traces) about the
|
|
51
|
-
* correlation between tasks and their outcomes. See `"Using AsyncResource for a Worker thread pool"` in the `async_hooks` documentation for an example implementation.
|
|
52
|
-
*
|
|
53
|
-
* Worker threads inherit non-process-specific options by default. Refer to `Worker constructor options` to know how to customize worker thread options,
|
|
54
|
-
* specifically `argv` and `execArgv` options.
|
|
55
|
-
* @see [source](https://github.com/nodejs/node/blob/v25.x/lib/worker_threads.js)
|
|
56
|
-
*/
|
|
57
1
|
declare module "node:worker_threads" {
|
|
58
2
|
import {
|
|
59
3
|
EventEmitter,
|
|
@@ -396,11 +340,15 @@ declare module "node:worker_threads" {
|
|
|
396
340
|
interface Worker extends InternalEventEmitter<WorkerEventMap> {}
|
|
397
341
|
/**
|
|
398
342
|
* Mark an object as not transferable. If `object` occurs in the transfer list of
|
|
399
|
-
* a `port.postMessage()` call,
|
|
343
|
+
* a [`port.postMessage()`](https://nodejs.org/docs/latest-v25.x/api/worker_threads.html#portpostmessagevalue-transferlist) call, an error is thrown. This is a no-op if
|
|
344
|
+
* `object` is a primitive value.
|
|
400
345
|
*
|
|
401
346
|
* In particular, this makes sense for objects that can be cloned, rather than
|
|
402
347
|
* transferred, and which are used by other objects on the sending side.
|
|
403
|
-
* For example, Node.js marks the `ArrayBuffer`s it uses for its
|
|
348
|
+
* For example, Node.js marks the `ArrayBuffer`s it uses for its
|
|
349
|
+
* [`Buffer` pool](https://nodejs.org/docs/latest-v25.x/api/buffer.html#static-method-bufferallocunsafesize) with this.
|
|
350
|
+
* `ArrayBuffer.prototype.transfer()` is disallowed on such array buffer
|
|
351
|
+
* instances.
|
|
404
352
|
*
|
|
405
353
|
* This operation cannot be undone.
|
|
406
354
|
*
|
|
@@ -414,11 +362,17 @@ declare module "node:worker_threads" {
|
|
|
414
362
|
* markAsUntransferable(pooledBuffer);
|
|
415
363
|
*
|
|
416
364
|
* const { port1 } = new MessageChannel();
|
|
417
|
-
*
|
|
365
|
+
* try {
|
|
366
|
+
* // This will throw an error, because pooledBuffer is not transferable.
|
|
367
|
+
* port1.postMessage(typedArray1, [ typedArray1.buffer ]);
|
|
368
|
+
* } catch (error) {
|
|
369
|
+
* // error.name === 'DataCloneError'
|
|
370
|
+
* }
|
|
418
371
|
*
|
|
419
372
|
* // The following line prints the contents of typedArray1 -- it still owns
|
|
420
|
-
* // its memory and has been
|
|
421
|
-
* // `markAsUntransferable()`, this would print an empty Uint8Array
|
|
373
|
+
* // its memory and has not been transferred. Without
|
|
374
|
+
* // `markAsUntransferable()`, this would print an empty Uint8Array and the
|
|
375
|
+
* // postMessage call would have succeeded.
|
|
422
376
|
* // typedArray2 is intact as well.
|
|
423
377
|
* console.log(typedArray1);
|
|
424
378
|
* console.log(typedArray2);
|
|
@@ -1,96 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The `node:zlib` module provides compression functionality implemented using
|
|
3
|
-
* Gzip, Deflate/Inflate, and Brotli.
|
|
4
|
-
*
|
|
5
|
-
* To access it:
|
|
6
|
-
*
|
|
7
|
-
* ```js
|
|
8
|
-
* import zlib from 'node:zlib';
|
|
9
|
-
* ```
|
|
10
|
-
*
|
|
11
|
-
* Compression and decompression are built around the Node.js
|
|
12
|
-
* [Streams API](https://nodejs.org/docs/latest-v25.x/api/stream.html).
|
|
13
|
-
*
|
|
14
|
-
* Compressing or decompressing a stream (such as a file) can be accomplished by
|
|
15
|
-
* piping the source stream through a `zlib` `Transform` stream into a destination
|
|
16
|
-
* stream:
|
|
17
|
-
*
|
|
18
|
-
* ```js
|
|
19
|
-
* import { createGzip } from 'node:zlib';
|
|
20
|
-
* import { pipeline } from 'node:stream';
|
|
21
|
-
* import {
|
|
22
|
-
* createReadStream,
|
|
23
|
-
* createWriteStream,
|
|
24
|
-
* } from 'node:fs';
|
|
25
|
-
*
|
|
26
|
-
* const gzip = createGzip();
|
|
27
|
-
* const source = createReadStream('input.txt');
|
|
28
|
-
* const destination = createWriteStream('input.txt.gz');
|
|
29
|
-
*
|
|
30
|
-
* pipeline(source, gzip, destination, (err) => {
|
|
31
|
-
* if (err) {
|
|
32
|
-
* console.error('An error occurred:', err);
|
|
33
|
-
* process.exitCode = 1;
|
|
34
|
-
* }
|
|
35
|
-
* });
|
|
36
|
-
*
|
|
37
|
-
* // Or, Promisified
|
|
38
|
-
*
|
|
39
|
-
* import { promisify } from 'node:util';
|
|
40
|
-
* const pipe = promisify(pipeline);
|
|
41
|
-
*
|
|
42
|
-
* async function do_gzip(input, output) {
|
|
43
|
-
* const gzip = createGzip();
|
|
44
|
-
* const source = createReadStream(input);
|
|
45
|
-
* const destination = createWriteStream(output);
|
|
46
|
-
* await pipe(source, gzip, destination);
|
|
47
|
-
* }
|
|
48
|
-
*
|
|
49
|
-
* do_gzip('input.txt', 'input.txt.gz')
|
|
50
|
-
* .catch((err) => {
|
|
51
|
-
* console.error('An error occurred:', err);
|
|
52
|
-
* process.exitCode = 1;
|
|
53
|
-
* });
|
|
54
|
-
* ```
|
|
55
|
-
*
|
|
56
|
-
* It is also possible to compress or decompress data in a single step:
|
|
57
|
-
*
|
|
58
|
-
* ```js
|
|
59
|
-
* import { deflate, unzip } from 'node:zlib';
|
|
60
|
-
*
|
|
61
|
-
* const input = '.................................';
|
|
62
|
-
* deflate(input, (err, buffer) => {
|
|
63
|
-
* if (err) {
|
|
64
|
-
* console.error('An error occurred:', err);
|
|
65
|
-
* process.exitCode = 1;
|
|
66
|
-
* }
|
|
67
|
-
* console.log(buffer.toString('base64'));
|
|
68
|
-
* });
|
|
69
|
-
*
|
|
70
|
-
* const buffer = Buffer.from('eJzT0yMAAGTvBe8=', 'base64');
|
|
71
|
-
* unzip(buffer, (err, buffer) => {
|
|
72
|
-
* if (err) {
|
|
73
|
-
* console.error('An error occurred:', err);
|
|
74
|
-
* process.exitCode = 1;
|
|
75
|
-
* }
|
|
76
|
-
* console.log(buffer.toString());
|
|
77
|
-
* });
|
|
78
|
-
*
|
|
79
|
-
* // Or, Promisified
|
|
80
|
-
*
|
|
81
|
-
* import { promisify } from 'node:util';
|
|
82
|
-
* const do_unzip = promisify(unzip);
|
|
83
|
-
*
|
|
84
|
-
* do_unzip(buffer)
|
|
85
|
-
* .then((buf) => console.log(buf.toString()))
|
|
86
|
-
* .catch((err) => {
|
|
87
|
-
* console.error('An error occurred:', err);
|
|
88
|
-
* process.exitCode = 1;
|
|
89
|
-
* });
|
|
90
|
-
* ```
|
|
91
|
-
* @since v0.5.8
|
|
92
|
-
* @see [source](https://github.com/nodejs/node/blob/v25.x/lib/zlib.js)
|
|
93
|
-
*/
|
|
94
1
|
declare module "node:zlib" {
|
|
95
2
|
import { NonSharedBuffer } from "node:buffer";
|
|
96
3
|
import * as stream from "node:stream";
|
|
@@ -39,6 +39,12 @@ declare namespace CacheHandler {
|
|
|
39
39
|
*/
|
|
40
40
|
type?: 'shared' | 'private'
|
|
41
41
|
|
|
42
|
+
/**
|
|
43
|
+
* Array of origins to cache. Only requests to these origins will be cached.
|
|
44
|
+
* Supports strings (case insensitive) and RegExp patterns.
|
|
45
|
+
* @default undefined (cache all origins)
|
|
46
|
+
*/
|
|
47
|
+
origins?: (string | RegExp)[]
|
|
42
48
|
}
|
|
43
49
|
|
|
44
50
|
export interface CacheControlDirectives {
|
|
@@ -92,6 +92,16 @@ export declare namespace Client {
|
|
|
92
92
|
* @default 100
|
|
93
93
|
*/
|
|
94
94
|
maxConcurrentStreams?: number;
|
|
95
|
+
/**
|
|
96
|
+
* @description Sets the HTTP/2 stream-level flow-control window size (SETTINGS_INITIAL_WINDOW_SIZE).
|
|
97
|
+
* @default 262144
|
|
98
|
+
*/
|
|
99
|
+
initialWindowSize?: number;
|
|
100
|
+
/**
|
|
101
|
+
* @description Sets the HTTP/2 connection-level flow-control window size (ClientHttp2Session.setLocalWindowSize).
|
|
102
|
+
* @default 524288
|
|
103
|
+
*/
|
|
104
|
+
connectionWindowSize?: number;
|
|
95
105
|
}
|
|
96
106
|
export interface SocketInfo {
|
|
97
107
|
localAddress?: string
|
|
@@ -8,7 +8,7 @@ This package contains type definitions for node (https://nodejs.org/).
|
|
|
8
8
|
Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
|
|
9
9
|
|
|
10
10
|
### Additional Details
|
|
11
|
-
* Last updated:
|
|
11
|
+
* Last updated: Fri, 10 Apr 2026 03:39:58 GMT
|
|
12
12
|
* Dependencies: [undici-types](https://npmjs.com/package/undici-types)
|
|
13
13
|
|
|
14
14
|
# Credits
|
|
@@ -1,49 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* In strict assertion mode, non-strict methods behave like their corresponding
|
|
3
|
-
* strict methods. For example, `assert.deepEqual()` will behave like
|
|
4
|
-
* `assert.deepStrictEqual()`.
|
|
5
|
-
*
|
|
6
|
-
* In strict assertion mode, error messages for objects display a diff. In legacy
|
|
7
|
-
* assertion mode, error messages for objects display the objects, often truncated.
|
|
8
|
-
*
|
|
9
|
-
* To use strict assertion mode:
|
|
10
|
-
*
|
|
11
|
-
* ```js
|
|
12
|
-
* import { strict as assert } from 'node:assert';
|
|
13
|
-
* ```
|
|
14
|
-
*
|
|
15
|
-
* ```js
|
|
16
|
-
* import assert from 'node:assert/strict';
|
|
17
|
-
* ```
|
|
18
|
-
*
|
|
19
|
-
* Example error diff:
|
|
20
|
-
*
|
|
21
|
-
* ```js
|
|
22
|
-
* import { strict as assert } from 'node:assert';
|
|
23
|
-
*
|
|
24
|
-
* assert.deepEqual([[[1, 2, 3]], 4, 5], [[[1, 2, '3']], 4, 5]);
|
|
25
|
-
* // AssertionError: Expected inputs to be strictly deep-equal:
|
|
26
|
-
* // + actual - expected ... Lines skipped
|
|
27
|
-
* //
|
|
28
|
-
* // [
|
|
29
|
-
* // [
|
|
30
|
-
* // ...
|
|
31
|
-
* // 2,
|
|
32
|
-
* // + 3
|
|
33
|
-
* // - '3'
|
|
34
|
-
* // ],
|
|
35
|
-
* // ...
|
|
36
|
-
* // 5
|
|
37
|
-
* // ]
|
|
38
|
-
* ```
|
|
39
|
-
*
|
|
40
|
-
* To deactivate the colors, use the `NO_COLOR` or `NODE_DISABLE_COLORS`
|
|
41
|
-
* environment variables. This will also deactivate the colors in the REPL. For
|
|
42
|
-
* more on color support in terminal environments, read the tty
|
|
43
|
-
* [`getColorDepth()`](https://nodejs.org/docs/latest-v25.x/api/tty.html#writestreamgetcolordepthenv) documentation.
|
|
44
|
-
* @since v15.0.0
|
|
45
|
-
* @see [source](https://github.com/nodejs/node/blob/v25.x/lib/assert/strict.js)
|
|
46
|
-
*/
|
|
47
1
|
declare module "node:assert/strict" {
|
|
48
2
|
import {
|
|
49
3
|
Assert,
|
|
@@ -1,8 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The `node:assert` module provides a set of assertion functions for verifying
|
|
3
|
-
* invariants.
|
|
4
|
-
* @see [source](https://github.com/nodejs/node/blob/v25.x/lib/assert.js)
|
|
5
|
-
*/
|
|
6
1
|
declare module "node:assert" {
|
|
7
2
|
import strict = require("node:assert/strict");
|
|
8
3
|
/**
|
|
@@ -1,19 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* We strongly discourage the use of the `async_hooks` API.
|
|
3
|
-
* Other APIs that can cover most of its use cases include:
|
|
4
|
-
*
|
|
5
|
-
* * [`AsyncLocalStorage`](https://nodejs.org/docs/latest-v25.x/api/async_context.html#class-asynclocalstorage) tracks async context
|
|
6
|
-
* * [`process.getActiveResourcesInfo()`](https://nodejs.org/docs/latest-v25.x/api/process.html#processgetactiveresourcesinfo) tracks active resources
|
|
7
|
-
*
|
|
8
|
-
* The `node:async_hooks` module provides an API to track asynchronous resources.
|
|
9
|
-
* It can be accessed using:
|
|
10
|
-
*
|
|
11
|
-
* ```js
|
|
12
|
-
* import async_hooks from 'node:async_hooks';
|
|
13
|
-
* ```
|
|
14
|
-
* @experimental
|
|
15
|
-
* @see [source](https://github.com/nodejs/node/blob/v25.x/lib/async_hooks.js)
|
|
16
|
-
*/
|
|
17
1
|
declare module "node:async_hooks" {
|
|
18
2
|
/**
|
|
19
3
|
* ```js
|
|
@@ -123,37 +107,31 @@ declare module "node:async_hooks" {
|
|
|
123
107
|
function triggerAsyncId(): number;
|
|
124
108
|
interface HookCallbacks {
|
|
125
109
|
/**
|
|
126
|
-
*
|
|
127
|
-
* @param asyncId A unique ID for the async resource
|
|
128
|
-
* @param type The type of the async resource
|
|
129
|
-
* @param triggerAsyncId The unique ID of the async resource in whose execution context this async resource was created
|
|
130
|
-
* @param resource Reference to the resource representing the async operation, needs to be released during destroy
|
|
110
|
+
* The [`init` callback](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#initasyncid-type-triggerasyncid-resource).
|
|
131
111
|
*/
|
|
132
112
|
init?(asyncId: number, type: string, triggerAsyncId: number, resource: object): void;
|
|
133
113
|
/**
|
|
134
|
-
*
|
|
135
|
-
* The before callback is called just before said callback is executed.
|
|
136
|
-
* @param asyncId the unique identifier assigned to the resource about to execute the callback.
|
|
114
|
+
* The [`before` callback](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#beforeasyncid).
|
|
137
115
|
*/
|
|
138
116
|
before?(asyncId: number): void;
|
|
139
117
|
/**
|
|
140
|
-
*
|
|
141
|
-
*
|
|
142
|
-
* If an uncaught exception occurs during execution of the callback, then `after` will run after the `'uncaughtException'` event is emitted or a `domain`'s handler runs.
|
|
143
|
-
* @param asyncId the unique identifier assigned to the resource which has executed the callback.
|
|
118
|
+
* The [`after` callback](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#afterasyncid).
|
|
144
119
|
*/
|
|
145
120
|
after?(asyncId: number): void;
|
|
146
121
|
/**
|
|
147
|
-
*
|
|
148
|
-
* as the promise itself.
|
|
149
|
-
* @param asyncId the unique id for the promise that was resolve()d.
|
|
122
|
+
* The [`promiseResolve` callback](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#promiseresolveasyncid).
|
|
150
123
|
*/
|
|
151
124
|
promiseResolve?(asyncId: number): void;
|
|
152
125
|
/**
|
|
153
|
-
*
|
|
154
|
-
* @param asyncId a unique ID for the async resource
|
|
126
|
+
* The [`destroy` callback](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#destroyasyncid).
|
|
155
127
|
*/
|
|
156
128
|
destroy?(asyncId: number): void;
|
|
129
|
+
/**
|
|
130
|
+
* Whether the hook should track `Promise`s. Cannot be `false` if
|
|
131
|
+
* `promiseResolve` is set.
|
|
132
|
+
* @default true
|
|
133
|
+
*/
|
|
134
|
+
trackPromises?: boolean | undefined;
|
|
157
135
|
}
|
|
158
136
|
interface AsyncHook {
|
|
159
137
|
/**
|
|
@@ -174,7 +152,8 @@ declare module "node:async_hooks" {
|
|
|
174
152
|
*
|
|
175
153
|
* All callbacks are optional. For example, if only resource cleanup needs to
|
|
176
154
|
* be tracked, then only the `destroy` callback needs to be passed. The
|
|
177
|
-
* specifics of all functions that can be passed to `callbacks` is in the
|
|
155
|
+
* specifics of all functions that can be passed to `callbacks` is in the
|
|
156
|
+
* [Hook Callbacks](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#hook-callbacks) section.
|
|
178
157
|
*
|
|
179
158
|
* ```js
|
|
180
159
|
* import { createHook } from 'node:async_hooks';
|
|
@@ -202,12 +181,13 @@ declare module "node:async_hooks" {
|
|
|
202
181
|
* ```
|
|
203
182
|
*
|
|
204
183
|
* Because promises are asynchronous resources whose lifecycle is tracked
|
|
205
|
-
* via the async hooks mechanism, the `init()`, `before()`, `after()`, and
|
|
184
|
+
* via the async hooks mechanism, the `init()`, `before()`, `after()`, and
|
|
185
|
+
* `destroy()` callbacks _must not_ be async functions that return promises.
|
|
206
186
|
* @since v8.1.0
|
|
207
|
-
* @param
|
|
208
|
-
* @
|
|
187
|
+
* @param options The [Hook Callbacks](https://nodejs.org/docs/latest-v25.x/api/async_hooks.html#hook-callbacks) to register
|
|
188
|
+
* @returns Instance used for disabling and enabling hooks
|
|
209
189
|
*/
|
|
210
|
-
function createHook(
|
|
190
|
+
function createHook(options: HookCallbacks): AsyncHook;
|
|
211
191
|
interface AsyncResourceOptions {
|
|
212
192
|
/**
|
|
213
193
|
* The ID of the execution context that created this async event.
|
|
@@ -174,7 +174,7 @@ declare module "node:buffer" {
|
|
|
174
174
|
* If `totalLength` is not provided, it is calculated from the `Buffer` instances
|
|
175
175
|
* in `list` by adding their lengths.
|
|
176
176
|
*
|
|
177
|
-
* If `totalLength` is provided, it
|
|
177
|
+
* If `totalLength` is provided, it must be an unsigned integer. If the
|
|
178
178
|
* combined length of the `Buffer`s in `list` exceeds `totalLength`, the result is
|
|
179
179
|
* truncated to `totalLength`. If the combined length of the `Buffer`s in `list` is
|
|
180
180
|
* less than `totalLength`, the remaining space is filled with zeros.
|
|
@@ -1,48 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* `Buffer` objects are used to represent a fixed-length sequence of bytes. Many
|
|
3
|
-
* Node.js APIs support `Buffer`s.
|
|
4
|
-
*
|
|
5
|
-
* The `Buffer` class is a subclass of JavaScript's [`Uint8Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) class and
|
|
6
|
-
* extends it with methods that cover additional use cases. Node.js APIs accept
|
|
7
|
-
* plain [`Uint8Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) s wherever `Buffer`s are supported as well.
|
|
8
|
-
*
|
|
9
|
-
* While the `Buffer` class is available within the global scope, it is still
|
|
10
|
-
* recommended to explicitly reference it via an import or require statement.
|
|
11
|
-
*
|
|
12
|
-
* ```js
|
|
13
|
-
* import { Buffer } from 'node:buffer';
|
|
14
|
-
*
|
|
15
|
-
* // Creates a zero-filled Buffer of length 10.
|
|
16
|
-
* const buf1 = Buffer.alloc(10);
|
|
17
|
-
*
|
|
18
|
-
* // Creates a Buffer of length 10,
|
|
19
|
-
* // filled with bytes which all have the value `1`.
|
|
20
|
-
* const buf2 = Buffer.alloc(10, 1);
|
|
21
|
-
*
|
|
22
|
-
* // Creates an uninitialized buffer of length 10.
|
|
23
|
-
* // This is faster than calling Buffer.alloc() but the returned
|
|
24
|
-
* // Buffer instance might contain old data that needs to be
|
|
25
|
-
* // overwritten using fill(), write(), or other functions that fill the Buffer's
|
|
26
|
-
* // contents.
|
|
27
|
-
* const buf3 = Buffer.allocUnsafe(10);
|
|
28
|
-
*
|
|
29
|
-
* // Creates a Buffer containing the bytes [1, 2, 3].
|
|
30
|
-
* const buf4 = Buffer.from([1, 2, 3]);
|
|
31
|
-
*
|
|
32
|
-
* // Creates a Buffer containing the bytes [1, 1, 1, 1] – the entries
|
|
33
|
-
* // are all truncated using `(value & 255)` to fit into the range 0–255.
|
|
34
|
-
* const buf5 = Buffer.from([257, 257.5, -255, '1']);
|
|
35
|
-
*
|
|
36
|
-
* // Creates a Buffer containing the UTF-8-encoded bytes for the string 'tést':
|
|
37
|
-
* // [0x74, 0xc3, 0xa9, 0x73, 0x74] (in hexadecimal notation)
|
|
38
|
-
* // [116, 195, 169, 115, 116] (in decimal notation)
|
|
39
|
-
* const buf6 = Buffer.from('tést');
|
|
40
|
-
*
|
|
41
|
-
* // Creates a Buffer containing the Latin-1 bytes [0x74, 0xe9, 0x73, 0x74].
|
|
42
|
-
* const buf7 = Buffer.from('tést', 'latin1');
|
|
43
|
-
* ```
|
|
44
|
-
* @see [source](https://github.com/nodejs/node/blob/v25.x/lib/buffer.js)
|
|
45
|
-
*/
|
|
46
1
|
declare module "node:buffer" {
|
|
47
2
|
import { ReadableStream } from "node:stream/web";
|
|
48
3
|
/**
|
|
@@ -1,70 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The `node:child_process` module provides the ability to spawn subprocesses in
|
|
3
|
-
* a manner that is similar, but not identical, to [`popen(3)`](http://man7.org/linux/man-pages/man3/popen.3.html). This capability
|
|
4
|
-
* is primarily provided by the {@link spawn} function:
|
|
5
|
-
*
|
|
6
|
-
* ```js
|
|
7
|
-
* import { spawn } from 'node:child_process';
|
|
8
|
-
* import { once } from 'node:events';
|
|
9
|
-
* const ls = spawn('ls', ['-lh', '/usr']);
|
|
10
|
-
*
|
|
11
|
-
* ls.stdout.on('data', (data) => {
|
|
12
|
-
* console.log(`stdout: ${data}`);
|
|
13
|
-
* });
|
|
14
|
-
*
|
|
15
|
-
* ls.stderr.on('data', (data) => {
|
|
16
|
-
* console.error(`stderr: ${data}`);
|
|
17
|
-
* });
|
|
18
|
-
*
|
|
19
|
-
* const [code] = await once(ls, 'close');
|
|
20
|
-
* console.log(`child process exited with code ${code}`);
|
|
21
|
-
* ```
|
|
22
|
-
*
|
|
23
|
-
* By default, pipes for `stdin`, `stdout`, and `stderr` are established between
|
|
24
|
-
* the parent Node.js process and the spawned subprocess. These pipes have
|
|
25
|
-
* limited (and platform-specific) capacity. If the subprocess writes to
|
|
26
|
-
* stdout in excess of that limit without the output being captured, the
|
|
27
|
-
* subprocess blocks, waiting for the pipe buffer to accept more data. This is
|
|
28
|
-
* identical to the behavior of pipes in the shell. Use the `{ stdio: 'ignore' }` option if the output will not be consumed.
|
|
29
|
-
*
|
|
30
|
-
* The command lookup is performed using the `options.env.PATH` environment
|
|
31
|
-
* variable if `env` is in the `options` object. Otherwise, `process.env.PATH` is
|
|
32
|
-
* used. If `options.env` is set without `PATH`, lookup on Unix is performed
|
|
33
|
-
* on a default search path search of `/usr/bin:/bin` (see your operating system's
|
|
34
|
-
* manual for execvpe/execvp), on Windows the current processes environment
|
|
35
|
-
* variable `PATH` is used.
|
|
36
|
-
*
|
|
37
|
-
* On Windows, environment variables are case-insensitive. Node.js
|
|
38
|
-
* lexicographically sorts the `env` keys and uses the first one that
|
|
39
|
-
* case-insensitively matches. Only first (in lexicographic order) entry will be
|
|
40
|
-
* passed to the subprocess. This might lead to issues on Windows when passing
|
|
41
|
-
* objects to the `env` option that have multiple variants of the same key, such as `PATH` and `Path`.
|
|
42
|
-
*
|
|
43
|
-
* The {@link spawn} method spawns the child process asynchronously,
|
|
44
|
-
* without blocking the Node.js event loop. The {@link spawnSync} function provides equivalent functionality in a synchronous manner that blocks
|
|
45
|
-
* the event loop until the spawned process either exits or is terminated.
|
|
46
|
-
*
|
|
47
|
-
* For convenience, the `node:child_process` module provides a handful of
|
|
48
|
-
* synchronous and asynchronous alternatives to {@link spawn} and {@link spawnSync}. Each of these alternatives are implemented on
|
|
49
|
-
* top of {@link spawn} or {@link spawnSync}.
|
|
50
|
-
*
|
|
51
|
-
* * {@link exec}: spawns a shell and runs a command within that
|
|
52
|
-
* shell, passing the `stdout` and `stderr` to a callback function when
|
|
53
|
-
* complete.
|
|
54
|
-
* * {@link execFile}: similar to {@link exec} except
|
|
55
|
-
* that it spawns the command directly without first spawning a shell by
|
|
56
|
-
* default.
|
|
57
|
-
* * {@link fork}: spawns a new Node.js process and invokes a
|
|
58
|
-
* specified module with an IPC communication channel established that allows
|
|
59
|
-
* sending messages between parent and child.
|
|
60
|
-
* * {@link execSync}: a synchronous version of {@link exec} that will block the Node.js event loop.
|
|
61
|
-
* * {@link execFileSync}: a synchronous version of {@link execFile} that will block the Node.js event loop.
|
|
62
|
-
*
|
|
63
|
-
* For certain use cases, such as automating shell scripts, the `synchronous counterparts` may be more convenient. In many cases, however,
|
|
64
|
-
* the synchronous methods can have significant impact on performance due to
|
|
65
|
-
* stalling the event loop while spawned processes complete.
|
|
66
|
-
* @see [source](https://github.com/nodejs/node/blob/v25.x/lib/child_process.js)
|
|
67
|
-
*/
|
|
68
1
|
declare module "node:child_process" {
|
|
69
2
|
import { NonSharedBuffer } from "node:buffer";
|
|
70
3
|
import * as dgram from "node:dgram";
|