@types/node 22.15.33 → 24.10.3

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.
Files changed (84) hide show
  1. node v24.10/README.md +15 -0
  2. node v24.10/assert/strict.d.ts +111 -0
  3. {node v22.15 → node v24.10}/assert.d.ts +162 -101
  4. {node v22.15 → node v24.10}/async_hooks.d.ts +26 -6
  5. {node v22.15 → node v24.10}/buffer.buffer.d.ts +9 -0
  6. {node v22.15 → node v24.10}/buffer.d.ts +15 -7
  7. {node v22.15 → node v24.10}/child_process.d.ts +91 -164
  8. {node v22.15 → node v24.10}/cluster.d.ts +19 -20
  9. {node v22.15 → node v24.10}/compatibility/iterators.d.ts +1 -0
  10. {node v22.15 → node v24.10}/console.d.ts +19 -18
  11. {node v22.15 → node v24.10}/crypto.d.ts +1264 -356
  12. {node v22.15 → node v24.10}/dgram.d.ts +10 -9
  13. {node v22.15 → node v24.10}/diagnostics_channel.d.ts +1 -3
  14. {node v22.15 → node v24.10}/dns/promises.d.ts +12 -11
  15. {node v22.15 → node v24.10}/dns.d.ts +41 -37
  16. {node v22.15 → node v24.10}/domain.d.ts +1 -1
  17. {node v22.15 → node v24.10}/events.d.ts +81 -36
  18. {node v22.15 → node v24.10}/fs/promises.d.ts +101 -57
  19. {node v22.15 → node v24.10}/fs.d.ts +413 -136
  20. node v24.10/globals.d.ts +170 -0
  21. node v24.10/globals.typedarray.d.ts +41 -0
  22. {node v22.15 → node v24.10}/http.d.ts +187 -37
  23. {node v22.15 → node v24.10}/http2.d.ts +197 -66
  24. {node v22.15 → node v24.10}/https.d.ts +97 -63
  25. {node v22.15 → node v24.10}/index.d.ts +16 -7
  26. node v24.10/inspector.d.ts +277 -0
  27. node v22.15/inspector.d.ts → node v24.10/inspector.generated.d.ts +1059 -828
  28. {node v22.15 → node v24.10}/module.d.ts +90 -30
  29. {node v22.15 → node v24.10}/net.d.ts +35 -16
  30. {node v22.15 → node v24.10}/os.d.ts +22 -10
  31. {node v22.15 → node v24.10}/package.json +14 -84
  32. {node v22.15 → node v24.10}/path.d.ts +2 -2
  33. {node v22.15 → node v24.10}/perf_hooks.d.ts +28 -16
  34. {node v22.15 → node v24.10}/process.d.ts +40 -34
  35. {node v22.15 → node v24.10}/punycode.d.ts +1 -1
  36. {node v22.15 → node v24.10}/querystring.d.ts +1 -1
  37. {node v22.15 → node v24.10}/readline/promises.d.ts +1 -2
  38. {node v22.15 → node v24.10}/readline.d.ts +13 -13
  39. {node v22.15 → node v24.10}/repl.d.ts +25 -17
  40. {node v22.15 → node v24.10}/sea.d.ts +10 -1
  41. {node v22.15 → node v24.10}/sqlite.d.ts +438 -9
  42. {node v22.15 → node v24.10}/stream/consumers.d.ts +2 -2
  43. {node v22.15 → node v24.10}/stream/web.d.ts +13 -54
  44. {node v22.15 → node v24.10}/stream.d.ts +63 -48
  45. {node v22.15 → node v24.10}/string_decoder.d.ts +3 -3
  46. node v24.10/test.d.ts +2339 -0
  47. {node v22.15 → node v24.10}/timers/promises.d.ts +1 -1
  48. {node v22.15 → node v24.10}/timers.d.ts +1 -3
  49. {node v22.15 → node v24.10}/tls.d.ts +124 -114
  50. {node v22.15 → node v24.10}/trace_events.d.ts +6 -6
  51. {node v22.15 → node v24.10}/ts5.6/buffer.buffer.d.ts +10 -2
  52. node v24.10/ts5.6/compatibility/float16array.d.ts +71 -0
  53. node v24.10/ts5.6/globals.typedarray.d.ts +36 -0
  54. {node v22.15 → node v24.10}/ts5.6/index.d.ts +18 -7
  55. node v24.10/ts5.7/compatibility/float16array.d.ts +72 -0
  56. node v24.10/ts5.7/index.d.ts +103 -0
  57. {node v22.15 → node v24.10}/tty.d.ts +1 -1
  58. {node v22.15 → node v24.10}/url.d.ts +119 -34
  59. {node v22.15 → node v24.10}/util.d.ts +45 -304
  60. {node v22.15 → node v24.10}/v8.d.ts +68 -38
  61. {node v22.15 → node v24.10}/vm.d.ts +258 -107
  62. {node v22.15 → node v24.10}/wasi.d.ts +23 -2
  63. node v24.10/web-globals/abortcontroller.d.ts +34 -0
  64. node v24.10/web-globals/crypto.d.ts +32 -0
  65. node v24.10/web-globals/domexception.d.ts +68 -0
  66. node v22.15/dom-events.d.ts → node v24.10/web-globals/events.d.ts +49 -51
  67. node v24.10/web-globals/fetch.d.ts +50 -0
  68. node v24.10/web-globals/navigator.d.ts +25 -0
  69. node v24.10/web-globals/storage.d.ts +24 -0
  70. node v24.10/web-globals/streams.d.ts +22 -0
  71. {node v22.15 → node v24.10}/worker_threads.d.ts +206 -68
  72. {node v22.15 → node v24.10}/zlib.d.ts +44 -33
  73. node v22.15/README.md +0 -15
  74. node v22.15/assert/strict.d.ts +0 -8
  75. node v22.15/compatibility/disposable.d.ts +0 -14
  76. node v22.15/compatibility/index.d.ts +0 -9
  77. node v22.15/compatibility/indexable.d.ts +0 -20
  78. node v22.15/globals.d.ts +0 -364
  79. node v22.15/globals.typedarray.d.ts +0 -21
  80. node v22.15/test.d.ts +0 -2278
  81. node v22.15/ts5.6/globals.typedarray.d.ts +0 -19
  82. {node v22.15 → node v24.10}/LICENSE +0 -0
  83. {node v22.15 → node v24.10}/constants.d.ts +0 -0
  84. {node v22.15 → node v24.10}/stream/promises.d.ts +0 -0
@@ -6,9 +6,10 @@
6
6
  * import http2 from 'node:http2';
7
7
  * ```
8
8
  * @since v8.4.0
9
- * @see [source](https://github.com/nodejs/node/blob/v22.x/lib/http2.js)
9
+ * @see [source](https://github.com/nodejs/node/blob/v24.x/lib/http2.js)
10
10
  */
11
11
  declare module "http2" {
12
+ import { NonSharedBuffer } from "node:buffer";
12
13
  import EventEmitter = require("node:events");
13
14
  import * as fs from "node:fs";
14
15
  import * as net from "node:net";
@@ -32,18 +33,14 @@ declare module "http2" {
32
33
  ":scheme"?: string | undefined;
33
34
  }
34
35
  // Http2Stream
35
- export interface StreamPriorityOptions {
36
- exclusive?: boolean | undefined;
37
- parent?: number | undefined;
38
- weight?: number | undefined;
39
- silent?: boolean | undefined;
40
- }
41
36
  export interface StreamState {
42
37
  localWindowSize?: number | undefined;
43
38
  state?: number | undefined;
44
39
  localClose?: number | undefined;
45
40
  remoteClose?: number | undefined;
41
+ /** @deprecated */
46
42
  sumDependencyWeight?: number | undefined;
43
+ /** @deprecated */
47
44
  weight?: number | undefined;
48
45
  }
49
46
  export interface ServerStreamResponseOptions {
@@ -55,14 +52,15 @@ declare module "http2" {
55
52
  length: number;
56
53
  }
57
54
  export interface ServerStreamFileResponseOptions {
58
- // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
59
- statCheck?(stats: fs.Stats, headers: OutgoingHttpHeaders, statOptions: StatOptions): void | boolean;
55
+ statCheck?:
56
+ | ((stats: fs.Stats, headers: OutgoingHttpHeaders, statOptions: StatOptions) => void)
57
+ | undefined;
60
58
  waitForTrailers?: boolean | undefined;
61
59
  offset?: number | undefined;
62
60
  length?: number | undefined;
63
61
  }
64
62
  export interface ServerStreamFileResponseOptionsWithError extends ServerStreamFileResponseOptions {
65
- onError?(err: NodeJS.ErrnoException): void;
63
+ onError?: ((err: NodeJS.ErrnoException) => void) | undefined;
66
64
  }
67
65
  export interface Http2Stream extends stream.Duplex {
68
66
  /**
@@ -151,10 +149,9 @@ declare module "http2" {
151
149
  */
152
150
  close(code?: number, callback?: () => void): void;
153
151
  /**
154
- * Updates the priority for this `Http2Stream` instance.
155
- * @since v8.4.0
152
+ * @deprecated Priority signaling is no longer supported in Node.js.
156
153
  */
157
- priority(options: StreamPriorityOptions): void;
154
+ priority(options: unknown): void;
158
155
  /**
159
156
  * ```js
160
157
  * import http2 from 'node:http2';
@@ -195,7 +192,7 @@ declare module "http2" {
195
192
  sendTrailers(headers: OutgoingHttpHeaders): void;
196
193
  addListener(event: "aborted", listener: () => void): this;
197
194
  addListener(event: "close", listener: () => void): this;
198
- addListener(event: "data", listener: (chunk: Buffer | string) => void): this;
195
+ addListener(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
199
196
  addListener(event: "drain", listener: () => void): this;
200
197
  addListener(event: "end", listener: () => void): this;
201
198
  addListener(event: "error", listener: (err: Error) => void): this;
@@ -210,7 +207,7 @@ declare module "http2" {
210
207
  addListener(event: string | symbol, listener: (...args: any[]) => void): this;
211
208
  emit(event: "aborted"): boolean;
212
209
  emit(event: "close"): boolean;
213
- emit(event: "data", chunk: Buffer | string): boolean;
210
+ emit(event: "data", chunk: NonSharedBuffer | string): boolean;
214
211
  emit(event: "drain"): boolean;
215
212
  emit(event: "end"): boolean;
216
213
  emit(event: "error", err: Error): boolean;
@@ -225,7 +222,7 @@ declare module "http2" {
225
222
  emit(event: string | symbol, ...args: any[]): boolean;
226
223
  on(event: "aborted", listener: () => void): this;
227
224
  on(event: "close", listener: () => void): this;
228
- on(event: "data", listener: (chunk: Buffer | string) => void): this;
225
+ on(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
229
226
  on(event: "drain", listener: () => void): this;
230
227
  on(event: "end", listener: () => void): this;
231
228
  on(event: "error", listener: (err: Error) => void): this;
@@ -240,7 +237,7 @@ declare module "http2" {
240
237
  on(event: string | symbol, listener: (...args: any[]) => void): this;
241
238
  once(event: "aborted", listener: () => void): this;
242
239
  once(event: "close", listener: () => void): this;
243
- once(event: "data", listener: (chunk: Buffer | string) => void): this;
240
+ once(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
244
241
  once(event: "drain", listener: () => void): this;
245
242
  once(event: "end", listener: () => void): this;
246
243
  once(event: "error", listener: (err: Error) => void): this;
@@ -255,7 +252,7 @@ declare module "http2" {
255
252
  once(event: string | symbol, listener: (...args: any[]) => void): this;
256
253
  prependListener(event: "aborted", listener: () => void): this;
257
254
  prependListener(event: "close", listener: () => void): this;
258
- prependListener(event: "data", listener: (chunk: Buffer | string) => void): this;
255
+ prependListener(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
259
256
  prependListener(event: "drain", listener: () => void): this;
260
257
  prependListener(event: "end", listener: () => void): this;
261
258
  prependListener(event: "error", listener: (err: Error) => void): this;
@@ -270,7 +267,7 @@ declare module "http2" {
270
267
  prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
271
268
  prependOnceListener(event: "aborted", listener: () => void): this;
272
269
  prependOnceListener(event: "close", listener: () => void): this;
273
- prependOnceListener(event: "data", listener: (chunk: Buffer | string) => void): this;
270
+ prependOnceListener(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
274
271
  prependOnceListener(event: "drain", listener: () => void): this;
275
272
  prependOnceListener(event: "end", listener: () => void): this;
276
273
  prependOnceListener(event: "error", listener: (err: Error) => void): this;
@@ -288,61 +285,111 @@ declare module "http2" {
288
285
  addListener(event: "continue", listener: () => {}): this;
289
286
  addListener(
290
287
  event: "headers",
291
- listener: (headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number) => void,
288
+ listener: (
289
+ headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
290
+ flags: number,
291
+ rawHeaders: string[],
292
+ ) => void,
292
293
  ): this;
293
294
  addListener(event: "push", listener: (headers: IncomingHttpHeaders, flags: number) => void): this;
294
295
  addListener(
295
296
  event: "response",
296
- listener: (headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number) => void,
297
+ listener: (
298
+ headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
299
+ flags: number,
300
+ rawHeaders: string[],
301
+ ) => void,
297
302
  ): this;
298
303
  addListener(event: string | symbol, listener: (...args: any[]) => void): this;
299
304
  emit(event: "continue"): boolean;
300
- emit(event: "headers", headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number): boolean;
305
+ emit(
306
+ event: "headers",
307
+ headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
308
+ flags: number,
309
+ rawHeaders: string[],
310
+ ): boolean;
301
311
  emit(event: "push", headers: IncomingHttpHeaders, flags: number): boolean;
302
- emit(event: "response", headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number): boolean;
312
+ emit(
313
+ event: "response",
314
+ headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
315
+ flags: number,
316
+ rawHeaders: string[],
317
+ ): boolean;
303
318
  emit(event: string | symbol, ...args: any[]): boolean;
304
319
  on(event: "continue", listener: () => {}): this;
305
320
  on(
306
321
  event: "headers",
307
- listener: (headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number) => void,
322
+ listener: (
323
+ headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
324
+ flags: number,
325
+ rawHeaders: string[],
326
+ ) => void,
308
327
  ): this;
309
328
  on(event: "push", listener: (headers: IncomingHttpHeaders, flags: number) => void): this;
310
329
  on(
311
330
  event: "response",
312
- listener: (headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number) => void,
331
+ listener: (
332
+ headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
333
+ flags: number,
334
+ rawHeaders: string[],
335
+ ) => void,
313
336
  ): this;
314
337
  on(event: string | symbol, listener: (...args: any[]) => void): this;
315
338
  once(event: "continue", listener: () => {}): this;
316
339
  once(
317
340
  event: "headers",
318
- listener: (headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number) => void,
341
+ listener: (
342
+ headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
343
+ flags: number,
344
+ rawHeaders: string[],
345
+ ) => void,
319
346
  ): this;
320
347
  once(event: "push", listener: (headers: IncomingHttpHeaders, flags: number) => void): this;
321
348
  once(
322
349
  event: "response",
323
- listener: (headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number) => void,
350
+ listener: (
351
+ headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
352
+ flags: number,
353
+ rawHeaders: string[],
354
+ ) => void,
324
355
  ): this;
325
356
  once(event: string | symbol, listener: (...args: any[]) => void): this;
326
357
  prependListener(event: "continue", listener: () => {}): this;
327
358
  prependListener(
328
359
  event: "headers",
329
- listener: (headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number) => void,
360
+ listener: (
361
+ headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
362
+ flags: number,
363
+ rawHeaders: string[],
364
+ ) => void,
330
365
  ): this;
331
366
  prependListener(event: "push", listener: (headers: IncomingHttpHeaders, flags: number) => void): this;
332
367
  prependListener(
333
368
  event: "response",
334
- listener: (headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number) => void,
369
+ listener: (
370
+ headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
371
+ flags: number,
372
+ rawHeaders: string[],
373
+ ) => void,
335
374
  ): this;
336
375
  prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
337
376
  prependOnceListener(event: "continue", listener: () => {}): this;
338
377
  prependOnceListener(
339
378
  event: "headers",
340
- listener: (headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number) => void,
379
+ listener: (
380
+ headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
381
+ flags: number,
382
+ rawHeaders: string[],
383
+ ) => void,
341
384
  ): this;
342
385
  prependOnceListener(event: "push", listener: (headers: IncomingHttpHeaders, flags: number) => void): this;
343
386
  prependOnceListener(
344
387
  event: "response",
345
- listener: (headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number) => void,
388
+ listener: (
389
+ headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
390
+ flags: number,
391
+ rawHeaders: string[],
392
+ ) => void,
346
393
  ): this;
347
394
  prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
348
395
  }
@@ -395,7 +442,7 @@ declare module "http2" {
395
442
  ): void;
396
443
  pushStream(
397
444
  headers: OutgoingHttpHeaders,
398
- options?: StreamPriorityOptions,
445
+ options?: Pick<ClientSessionRequestOptions, "exclusive" | "parent">,
399
446
  callback?: (err: Error | null, pushStream: ServerHttp2Stream, headers: OutgoingHttpHeaders) => void,
400
447
  ): void;
401
448
  /**
@@ -428,7 +475,7 @@ declare module "http2" {
428
475
  * ```
429
476
  * @since v8.4.0
430
477
  */
431
- respond(headers?: OutgoingHttpHeaders, options?: ServerStreamResponseOptions): void;
478
+ respond(headers?: OutgoingHttpHeaders | readonly string[], options?: ServerStreamResponseOptions): void;
432
479
  /**
433
480
  * Initiates a response whose data is read from the given file descriptor. No
434
481
  * validation is performed on the given file descriptor. If an error occurs while
@@ -629,7 +676,6 @@ declare module "http2" {
629
676
  endStream?: boolean | undefined;
630
677
  exclusive?: boolean | undefined;
631
678
  parent?: number | undefined;
632
- weight?: number | undefined;
633
679
  waitForTrailers?: boolean | undefined;
634
680
  signal?: AbortSignal | undefined;
635
681
  }
@@ -789,10 +835,10 @@ declare module "http2" {
789
835
  * @since v8.9.3
790
836
  * @param payload Optional ping payload.
791
837
  */
792
- ping(callback: (err: Error | null, duration: number, payload: Buffer) => void): boolean;
838
+ ping(callback: (err: Error | null, duration: number, payload: NonSharedBuffer) => void): boolean;
793
839
  ping(
794
840
  payload: NodeJS.ArrayBufferView,
795
- callback: (err: Error | null, duration: number, payload: Buffer) => void,
841
+ callback: (err: Error | null, duration: number, payload: NonSharedBuffer) => void,
796
842
  ): boolean;
797
843
  /**
798
844
  * Calls `ref()` on this `Http2Session` instance's underlying `net.Socket`.
@@ -854,7 +900,7 @@ declare module "http2" {
854
900
  ): this;
855
901
  addListener(
856
902
  event: "goaway",
857
- listener: (errorCode: number, lastStreamID: number, opaqueData?: Buffer) => void,
903
+ listener: (errorCode: number, lastStreamID: number, opaqueData?: NonSharedBuffer) => void,
858
904
  ): this;
859
905
  addListener(event: "localSettings", listener: (settings: Settings) => void): this;
860
906
  addListener(event: "ping", listener: () => void): this;
@@ -864,7 +910,7 @@ declare module "http2" {
864
910
  emit(event: "close"): boolean;
865
911
  emit(event: "error", err: Error): boolean;
866
912
  emit(event: "frameError", frameType: number, errorCode: number, streamID: number): boolean;
867
- emit(event: "goaway", errorCode: number, lastStreamID: number, opaqueData?: Buffer): boolean;
913
+ emit(event: "goaway", errorCode: number, lastStreamID: number, opaqueData?: NonSharedBuffer): boolean;
868
914
  emit(event: "localSettings", settings: Settings): boolean;
869
915
  emit(event: "ping"): boolean;
870
916
  emit(event: "remoteSettings", settings: Settings): boolean;
@@ -873,7 +919,10 @@ declare module "http2" {
873
919
  on(event: "close", listener: () => void): this;
874
920
  on(event: "error", listener: (err: Error) => void): this;
875
921
  on(event: "frameError", listener: (frameType: number, errorCode: number, streamID: number) => void): this;
876
- on(event: "goaway", listener: (errorCode: number, lastStreamID: number, opaqueData?: Buffer) => void): this;
922
+ on(
923
+ event: "goaway",
924
+ listener: (errorCode: number, lastStreamID: number, opaqueData?: NonSharedBuffer) => void,
925
+ ): this;
877
926
  on(event: "localSettings", listener: (settings: Settings) => void): this;
878
927
  on(event: "ping", listener: () => void): this;
879
928
  on(event: "remoteSettings", listener: (settings: Settings) => void): this;
@@ -882,7 +931,10 @@ declare module "http2" {
882
931
  once(event: "close", listener: () => void): this;
883
932
  once(event: "error", listener: (err: Error) => void): this;
884
933
  once(event: "frameError", listener: (frameType: number, errorCode: number, streamID: number) => void): this;
885
- once(event: "goaway", listener: (errorCode: number, lastStreamID: number, opaqueData?: Buffer) => void): this;
934
+ once(
935
+ event: "goaway",
936
+ listener: (errorCode: number, lastStreamID: number, opaqueData?: NonSharedBuffer) => void,
937
+ ): this;
886
938
  once(event: "localSettings", listener: (settings: Settings) => void): this;
887
939
  once(event: "ping", listener: () => void): this;
888
940
  once(event: "remoteSettings", listener: (settings: Settings) => void): this;
@@ -896,7 +948,7 @@ declare module "http2" {
896
948
  ): this;
897
949
  prependListener(
898
950
  event: "goaway",
899
- listener: (errorCode: number, lastStreamID: number, opaqueData?: Buffer) => void,
951
+ listener: (errorCode: number, lastStreamID: number, opaqueData?: NonSharedBuffer) => void,
900
952
  ): this;
901
953
  prependListener(event: "localSettings", listener: (settings: Settings) => void): this;
902
954
  prependListener(event: "ping", listener: () => void): this;
@@ -911,7 +963,7 @@ declare module "http2" {
911
963
  ): this;
912
964
  prependOnceListener(
913
965
  event: "goaway",
914
- listener: (errorCode: number, lastStreamID: number, opaqueData?: Buffer) => void,
966
+ listener: (errorCode: number, lastStreamID: number, opaqueData?: NonSharedBuffer) => void,
915
967
  ): this;
916
968
  prependOnceListener(event: "localSettings", listener: (settings: Settings) => void): this;
917
969
  prependOnceListener(event: "ping", listener: () => void): this;
@@ -965,7 +1017,10 @@ declare module "http2" {
965
1017
  * * `:path` \= `/`
966
1018
  * @since v8.4.0
967
1019
  */
968
- request(headers?: OutgoingHttpHeaders, options?: ClientSessionRequestOptions): ClientHttp2Stream;
1020
+ request(
1021
+ headers?: OutgoingHttpHeaders | readonly string[],
1022
+ options?: ClientSessionRequestOptions,
1023
+ ): ClientHttp2Stream;
969
1024
  addListener(event: "altsvc", listener: (alt: string, origin: string, stream: number) => void): this;
970
1025
  addListener(event: "origin", listener: (origins: string[]) => void): this;
971
1026
  addListener(
@@ -978,6 +1033,7 @@ declare module "http2" {
978
1033
  stream: ClientHttp2Stream,
979
1034
  headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
980
1035
  flags: number,
1036
+ rawHeaders: string[],
981
1037
  ) => void,
982
1038
  ): this;
983
1039
  addListener(event: string | symbol, listener: (...args: any[]) => void): this;
@@ -989,6 +1045,7 @@ declare module "http2" {
989
1045
  stream: ClientHttp2Stream,
990
1046
  headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
991
1047
  flags: number,
1048
+ rawHeaders: string[],
992
1049
  ): boolean;
993
1050
  emit(event: string | symbol, ...args: any[]): boolean;
994
1051
  on(event: "altsvc", listener: (alt: string, origin: string, stream: number) => void): this;
@@ -1000,6 +1057,7 @@ declare module "http2" {
1000
1057
  stream: ClientHttp2Stream,
1001
1058
  headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
1002
1059
  flags: number,
1060
+ rawHeaders: string[],
1003
1061
  ) => void,
1004
1062
  ): this;
1005
1063
  on(event: string | symbol, listener: (...args: any[]) => void): this;
@@ -1015,6 +1073,7 @@ declare module "http2" {
1015
1073
  stream: ClientHttp2Stream,
1016
1074
  headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
1017
1075
  flags: number,
1076
+ rawHeaders: string[],
1018
1077
  ) => void,
1019
1078
  ): this;
1020
1079
  once(event: string | symbol, listener: (...args: any[]) => void): this;
@@ -1030,6 +1089,7 @@ declare module "http2" {
1030
1089
  stream: ClientHttp2Stream,
1031
1090
  headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
1032
1091
  flags: number,
1092
+ rawHeaders: string[],
1033
1093
  ) => void,
1034
1094
  ): this;
1035
1095
  prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
@@ -1045,6 +1105,7 @@ declare module "http2" {
1045
1105
  stream: ClientHttp2Stream,
1046
1106
  headers: IncomingHttpHeaders & IncomingHttpStatusHeader,
1047
1107
  flags: number,
1108
+ rawHeaders: string[],
1048
1109
  ) => void,
1049
1110
  ): this;
1050
1111
  prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
@@ -1162,7 +1223,12 @@ declare module "http2" {
1162
1223
  ): this;
1163
1224
  addListener(
1164
1225
  event: "stream",
1165
- listener: (stream: ServerHttp2Stream, headers: IncomingHttpHeaders, flags: number) => void,
1226
+ listener: (
1227
+ stream: ServerHttp2Stream,
1228
+ headers: IncomingHttpHeaders,
1229
+ flags: number,
1230
+ rawHeaders: string[],
1231
+ ) => void,
1166
1232
  ): this;
1167
1233
  addListener(event: string | symbol, listener: (...args: any[]) => void): this;
1168
1234
  emit(
@@ -1170,7 +1236,13 @@ declare module "http2" {
1170
1236
  session: ServerHttp2Session<Http1Request, Http1Response, Http2Request, Http2Response>,
1171
1237
  socket: net.Socket | tls.TLSSocket,
1172
1238
  ): boolean;
1173
- emit(event: "stream", stream: ServerHttp2Stream, headers: IncomingHttpHeaders, flags: number): boolean;
1239
+ emit(
1240
+ event: "stream",
1241
+ stream: ServerHttp2Stream,
1242
+ headers: IncomingHttpHeaders,
1243
+ flags: number,
1244
+ rawHeaders: string[],
1245
+ ): boolean;
1174
1246
  emit(event: string | symbol, ...args: any[]): boolean;
1175
1247
  on(
1176
1248
  event: "connect",
@@ -1181,7 +1253,12 @@ declare module "http2" {
1181
1253
  ): this;
1182
1254
  on(
1183
1255
  event: "stream",
1184
- listener: (stream: ServerHttp2Stream, headers: IncomingHttpHeaders, flags: number) => void,
1256
+ listener: (
1257
+ stream: ServerHttp2Stream,
1258
+ headers: IncomingHttpHeaders,
1259
+ flags: number,
1260
+ rawHeaders: string[],
1261
+ ) => void,
1185
1262
  ): this;
1186
1263
  on(event: string | symbol, listener: (...args: any[]) => void): this;
1187
1264
  once(
@@ -1193,7 +1270,12 @@ declare module "http2" {
1193
1270
  ): this;
1194
1271
  once(
1195
1272
  event: "stream",
1196
- listener: (stream: ServerHttp2Stream, headers: IncomingHttpHeaders, flags: number) => void,
1273
+ listener: (
1274
+ stream: ServerHttp2Stream,
1275
+ headers: IncomingHttpHeaders,
1276
+ flags: number,
1277
+ rawHeaders: string[],
1278
+ ) => void,
1197
1279
  ): this;
1198
1280
  once(event: string | symbol, listener: (...args: any[]) => void): this;
1199
1281
  prependListener(
@@ -1205,7 +1287,12 @@ declare module "http2" {
1205
1287
  ): this;
1206
1288
  prependListener(
1207
1289
  event: "stream",
1208
- listener: (stream: ServerHttp2Stream, headers: IncomingHttpHeaders, flags: number) => void,
1290
+ listener: (
1291
+ stream: ServerHttp2Stream,
1292
+ headers: IncomingHttpHeaders,
1293
+ flags: number,
1294
+ rawHeaders: string[],
1295
+ ) => void,
1209
1296
  ): this;
1210
1297
  prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
1211
1298
  prependOnceListener(
@@ -1217,7 +1304,12 @@ declare module "http2" {
1217
1304
  ): this;
1218
1305
  prependOnceListener(
1219
1306
  event: "stream",
1220
- listener: (stream: ServerHttp2Stream, headers: IncomingHttpHeaders, flags: number) => void,
1307
+ listener: (
1308
+ stream: ServerHttp2Stream,
1309
+ headers: IncomingHttpHeaders,
1310
+ flags: number,
1311
+ rawHeaders: string[],
1312
+ ) => void,
1221
1313
  ): this;
1222
1314
  prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
1223
1315
  }
@@ -1291,6 +1383,14 @@ declare module "http2" {
1291
1383
  * @default 100000
1292
1384
  */
1293
1385
  unknownProtocolTimeout?: number | undefined;
1386
+ /**
1387
+ * If `true`, it turns on strict leading
1388
+ * and trailing whitespace validation for HTTP/2 header field names and values
1389
+ * as per [RFC-9113](https://www.rfc-editor.org/rfc/rfc9113.html#section-8.2.1).
1390
+ * @since v24.2.0
1391
+ * @default true
1392
+ */
1393
+ strictFieldWhitespaceValidation?: boolean | undefined;
1294
1394
  }
1295
1395
  export interface ClientSessionOptions extends SessionOptions {
1296
1396
  /**
@@ -1378,7 +1478,12 @@ declare module "http2" {
1378
1478
  addListener(event: "sessionError", listener: (err: Error) => void): this;
1379
1479
  addListener(
1380
1480
  event: "stream",
1381
- listener: (stream: ServerHttp2Stream, headers: IncomingHttpHeaders, flags: number) => void,
1481
+ listener: (
1482
+ stream: ServerHttp2Stream,
1483
+ headers: IncomingHttpHeaders,
1484
+ flags: number,
1485
+ rawHeaders: string[],
1486
+ ) => void,
1382
1487
  ): this;
1383
1488
  addListener(event: "timeout", listener: () => void): this;
1384
1489
  addListener(event: string | symbol, listener: (...args: any[]) => void): this;
@@ -1393,7 +1498,13 @@ declare module "http2" {
1393
1498
  session: ServerHttp2Session<Http1Request, Http1Response, Http2Request, Http2Response>,
1394
1499
  ): boolean;
1395
1500
  emit(event: "sessionError", err: Error): boolean;
1396
- emit(event: "stream", stream: ServerHttp2Stream, headers: IncomingHttpHeaders, flags: number): boolean;
1501
+ emit(
1502
+ event: "stream",
1503
+ stream: ServerHttp2Stream,
1504
+ headers: IncomingHttpHeaders,
1505
+ flags: number,
1506
+ rawHeaders: string[],
1507
+ ): boolean;
1397
1508
  emit(event: "timeout"): boolean;
1398
1509
  emit(event: string | symbol, ...args: any[]): boolean;
1399
1510
  on(
@@ -1411,7 +1522,12 @@ declare module "http2" {
1411
1522
  on(event: "sessionError", listener: (err: Error) => void): this;
1412
1523
  on(
1413
1524
  event: "stream",
1414
- listener: (stream: ServerHttp2Stream, headers: IncomingHttpHeaders, flags: number) => void,
1525
+ listener: (
1526
+ stream: ServerHttp2Stream,
1527
+ headers: IncomingHttpHeaders,
1528
+ flags: number,
1529
+ rawHeaders: string[],
1530
+ ) => void,
1415
1531
  ): this;
1416
1532
  on(event: "timeout", listener: () => void): this;
1417
1533
  on(event: string | symbol, listener: (...args: any[]) => void): this;
@@ -1430,7 +1546,12 @@ declare module "http2" {
1430
1546
  once(event: "sessionError", listener: (err: Error) => void): this;
1431
1547
  once(
1432
1548
  event: "stream",
1433
- listener: (stream: ServerHttp2Stream, headers: IncomingHttpHeaders, flags: number) => void,
1549
+ listener: (
1550
+ stream: ServerHttp2Stream,
1551
+ headers: IncomingHttpHeaders,
1552
+ flags: number,
1553
+ rawHeaders: string[],
1554
+ ) => void,
1434
1555
  ): this;
1435
1556
  once(event: "timeout", listener: () => void): this;
1436
1557
  once(event: string | symbol, listener: (...args: any[]) => void): this;
@@ -1449,7 +1570,12 @@ declare module "http2" {
1449
1570
  prependListener(event: "sessionError", listener: (err: Error) => void): this;
1450
1571
  prependListener(
1451
1572
  event: "stream",
1452
- listener: (stream: ServerHttp2Stream, headers: IncomingHttpHeaders, flags: number) => void,
1573
+ listener: (
1574
+ stream: ServerHttp2Stream,
1575
+ headers: IncomingHttpHeaders,
1576
+ flags: number,
1577
+ rawHeaders: string[],
1578
+ ) => void,
1453
1579
  ): this;
1454
1580
  prependListener(event: "timeout", listener: () => void): this;
1455
1581
  prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
@@ -1468,7 +1594,12 @@ declare module "http2" {
1468
1594
  prependOnceListener(event: "sessionError", listener: (err: Error) => void): this;
1469
1595
  prependOnceListener(
1470
1596
  event: "stream",
1471
- listener: (stream: ServerHttp2Stream, headers: IncomingHttpHeaders, flags: number) => void,
1597
+ listener: (
1598
+ stream: ServerHttp2Stream,
1599
+ headers: IncomingHttpHeaders,
1600
+ flags: number,
1601
+ rawHeaders: string[],
1602
+ ) => void,
1472
1603
  ): this;
1473
1604
  prependOnceListener(event: "timeout", listener: () => void): this;
1474
1605
  prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
@@ -1792,45 +1923,45 @@ declare module "http2" {
1792
1923
  * @since v8.4.0
1793
1924
  */
1794
1925
  setTimeout(msecs: number, callback?: () => void): void;
1795
- read(size?: number): Buffer | string | null;
1926
+ read(size?: number): NonSharedBuffer | string | null;
1796
1927
  addListener(event: "aborted", listener: (hadError: boolean, code: number) => void): this;
1797
1928
  addListener(event: "close", listener: () => void): this;
1798
- addListener(event: "data", listener: (chunk: Buffer | string) => void): this;
1929
+ addListener(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
1799
1930
  addListener(event: "end", listener: () => void): this;
1800
1931
  addListener(event: "readable", listener: () => void): this;
1801
1932
  addListener(event: "error", listener: (err: Error) => void): this;
1802
1933
  addListener(event: string | symbol, listener: (...args: any[]) => void): this;
1803
1934
  emit(event: "aborted", hadError: boolean, code: number): boolean;
1804
1935
  emit(event: "close"): boolean;
1805
- emit(event: "data", chunk: Buffer | string): boolean;
1936
+ emit(event: "data", chunk: NonSharedBuffer | string): boolean;
1806
1937
  emit(event: "end"): boolean;
1807
1938
  emit(event: "readable"): boolean;
1808
1939
  emit(event: "error", err: Error): boolean;
1809
1940
  emit(event: string | symbol, ...args: any[]): boolean;
1810
1941
  on(event: "aborted", listener: (hadError: boolean, code: number) => void): this;
1811
1942
  on(event: "close", listener: () => void): this;
1812
- on(event: "data", listener: (chunk: Buffer | string) => void): this;
1943
+ on(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
1813
1944
  on(event: "end", listener: () => void): this;
1814
1945
  on(event: "readable", listener: () => void): this;
1815
1946
  on(event: "error", listener: (err: Error) => void): this;
1816
1947
  on(event: string | symbol, listener: (...args: any[]) => void): this;
1817
1948
  once(event: "aborted", listener: (hadError: boolean, code: number) => void): this;
1818
1949
  once(event: "close", listener: () => void): this;
1819
- once(event: "data", listener: (chunk: Buffer | string) => void): this;
1950
+ once(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
1820
1951
  once(event: "end", listener: () => void): this;
1821
1952
  once(event: "readable", listener: () => void): this;
1822
1953
  once(event: "error", listener: (err: Error) => void): this;
1823
1954
  once(event: string | symbol, listener: (...args: any[]) => void): this;
1824
1955
  prependListener(event: "aborted", listener: (hadError: boolean, code: number) => void): this;
1825
1956
  prependListener(event: "close", listener: () => void): this;
1826
- prependListener(event: "data", listener: (chunk: Buffer | string) => void): this;
1957
+ prependListener(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
1827
1958
  prependListener(event: "end", listener: () => void): this;
1828
1959
  prependListener(event: "readable", listener: () => void): this;
1829
1960
  prependListener(event: "error", listener: (err: Error) => void): this;
1830
1961
  prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
1831
1962
  prependOnceListener(event: "aborted", listener: (hadError: boolean, code: number) => void): this;
1832
1963
  prependOnceListener(event: "close", listener: () => void): this;
1833
- prependOnceListener(event: "data", listener: (chunk: Buffer | string) => void): this;
1964
+ prependOnceListener(event: "data", listener: (chunk: NonSharedBuffer | string) => void): this;
1834
1965
  prependOnceListener(event: "end", listener: () => void): this;
1835
1966
  prependOnceListener(event: "readable", listener: () => void): this;
1836
1967
  prependOnceListener(event: "error", listener: (err: Error) => void): this;
@@ -1857,7 +1988,7 @@ declare module "http2" {
1857
1988
  * If there were no previous values for the header, this is equivalent to calling {@link setHeader}.
1858
1989
  *
1859
1990
  * Attempting to set a header field name or value that contains invalid characters will result in a
1860
- * [TypeError](https://nodejs.org/docs/latest-v22.x/api/errors.html#class-typeerror) being thrown.
1991
+ * [TypeError](https://nodejs.org/docs/latest-v24.x/api/errors.html#class-typeerror) being thrown.
1861
1992
  *
1862
1993
  * ```js
1863
1994
  * // Returns headers including "set-cookie: a" and "set-cookie: b"
@@ -2189,8 +2320,8 @@ declare module "http2" {
2189
2320
  * will result in a `TypeError` being thrown.
2190
2321
  * @since v8.4.0
2191
2322
  */
2192
- writeHead(statusCode: number, headers?: OutgoingHttpHeaders): this;
2193
- writeHead(statusCode: number, statusMessage: string, headers?: OutgoingHttpHeaders): this;
2323
+ writeHead(statusCode: number, headers?: OutgoingHttpHeaders | readonly string[]): this;
2324
+ writeHead(statusCode: number, statusMessage: string, headers?: OutgoingHttpHeaders | readonly string[]): this;
2194
2325
  /**
2195
2326
  * Call `http2stream.pushStream()` with the given headers, and wrap the
2196
2327
  * given `Http2Stream` on a newly created `Http2ServerResponse` as the callback
@@ -2490,7 +2621,7 @@ declare module "http2" {
2490
2621
  * ```
2491
2622
  * @since v8.4.0
2492
2623
  */
2493
- export function getPackedSettings(settings: Settings): Buffer;
2624
+ export function getPackedSettings(settings: Settings): NonSharedBuffer;
2494
2625
  /**
2495
2626
  * Returns a `HTTP/2 Settings Object` containing the deserialized settings from
2496
2627
  * the given `Buffer` as generated by `http2.getPackedSettings()`.