@types/node 16.11.55 → 16.11.58

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.
node v16.11/README.md CHANGED
@@ -8,7 +8,7 @@ This package contains type definitions for Node.js (https://nodejs.org/).
8
8
  Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node/v16.
9
9
 
10
10
  ### Additional Details
11
- * Last updated: Tue, 23 Aug 2022 20:32:35 GMT
11
+ * Last updated: Wed, 07 Sep 2022 20:32:44 GMT
12
12
  * Dependencies: none
13
13
  * Global values: `AbortController`, `AbortSignal`, `__dirname`, `__filename`, `console`, `exports`, `gc`, `global`, `module`, `process`, `require`
14
14
 
node v16.11/http.d.ts CHANGED
@@ -135,12 +135,17 @@ declare module 'http' {
135
135
  timeout?: number | undefined;
136
136
  setHost?: boolean | undefined;
137
137
  // https://github.com/nodejs/node/blob/master/lib/_http_client.js#L278
138
- createConnection?: ((options: ClientRequestArgs, oncreate: (err: Error, socket: Socket) => void) => Socket) | undefined;
138
+ createConnection?:
139
+ | ((options: ClientRequestArgs, oncreate: (err: Error, socket: Socket) => void) => Socket)
140
+ | undefined;
139
141
  lookup?: LookupFunction | undefined;
140
142
  }
141
- interface ServerOptions {
142
- IncomingMessage?: typeof IncomingMessage | undefined;
143
- ServerResponse?: typeof ServerResponse | undefined;
143
+ interface ServerOptions<
144
+ Request extends typeof IncomingMessage = typeof IncomingMessage,
145
+ Response extends typeof ServerResponse = typeof ServerResponse,
146
+ > {
147
+ IncomingMessage?: Request | undefined;
148
+ ServerResponse?: Response | undefined;
144
149
  /**
145
150
  * Optionally overrides the value of
146
151
  * `--max-http-header-size` for requests received by this server, i.e.
@@ -155,14 +160,39 @@ declare module 'http' {
155
160
  * @default false
156
161
  */
157
162
  insecureHTTPParser?: boolean | undefined;
163
+ /**
164
+ * If set to `true`, it disables the use of Nagle's algorithm immediately after a new incoming connection is received.
165
+ * @default false
166
+ * @since v16.5.0
167
+ */
168
+ noDelay?: boolean | undefined;
169
+ /**
170
+ * If set to `true`, it enables keep-alive functionality on the socket immediately after a new incoming connection is received,
171
+ * similarly on what is done in `socket.setKeepAlive([enable][, initialDelay])`.
172
+ * @default false
173
+ * @since v16.5.0
174
+ */
175
+ keepAlive?: boolean | undefined;
176
+ /**
177
+ * If set to a positive number, it sets the initial delay before the first keepalive probe is sent on an idle socket.
178
+ * @default 0
179
+ * @since v16.5.0
180
+ */
181
+ keepAliveInitialDelay?: number | undefined;
158
182
  }
159
- type RequestListener = (req: IncomingMessage, res: ServerResponse) => void;
183
+ type RequestListener<
184
+ Request extends typeof IncomingMessage = typeof IncomingMessage,
185
+ Response extends typeof ServerResponse = typeof ServerResponse,
186
+ > = (req: InstanceType<Request>, res: InstanceType<Response> & { req: InstanceType<Request> }) => void;
160
187
  /**
161
188
  * @since v0.1.17
162
189
  */
163
- class Server extends NetServer {
164
- constructor(requestListener?: RequestListener);
165
- constructor(options: ServerOptions, requestListener?: RequestListener);
190
+ class Server<
191
+ Request extends typeof IncomingMessage = typeof IncomingMessage,
192
+ Response extends typeof ServerResponse = typeof ServerResponse,
193
+ > extends NetServer {
194
+ constructor(requestListener?: RequestListener<Request, Response>);
195
+ constructor(options: ServerOptions<Request, Response>, requestListener?: RequestListener<Request, Response>);
166
196
  /**
167
197
  * Sets the timeout value for sockets, and emits a `'timeout'` event on
168
198
  * the Server object, passing the socket as an argument, if a timeout
@@ -256,75 +286,111 @@ declare module 'http' {
256
286
  addListener(event: 'connection', listener: (socket: Socket) => void): this;
257
287
  addListener(event: 'error', listener: (err: Error) => void): this;
258
288
  addListener(event: 'listening', listener: () => void): this;
259
- addListener(event: 'checkContinue', listener: RequestListener): this;
260
- addListener(event: 'checkExpectation', listener: RequestListener): this;
289
+ addListener(event: 'checkContinue', listener: RequestListener<Request, Response>): this;
290
+ addListener(event: 'checkExpectation', listener: RequestListener<Request, Response>): this;
261
291
  addListener(event: 'clientError', listener: (err: Error, socket: stream.Duplex) => void): this;
262
- addListener(event: 'connect', listener: (req: IncomingMessage, socket: stream.Duplex, head: Buffer) => void): this;
263
- addListener(event: 'request', listener: RequestListener): this;
264
- addListener(event: 'upgrade', listener: (req: IncomingMessage, socket: stream.Duplex, head: Buffer) => void): this;
292
+ addListener(
293
+ event: 'connect',
294
+ listener: (req: InstanceType<Request>, socket: stream.Duplex, head: Buffer) => void,
295
+ ): this;
296
+ addListener(event: 'request', listener: RequestListener<Request, Response>): this;
297
+ addListener(
298
+ event: 'upgrade',
299
+ listener: (req: InstanceType<Request>, socket: stream.Duplex, head: Buffer) => void,
300
+ ): this;
265
301
  emit(event: string, ...args: any[]): boolean;
266
302
  emit(event: 'close'): boolean;
267
303
  emit(event: 'connection', socket: Socket): boolean;
268
304
  emit(event: 'error', err: Error): boolean;
269
305
  emit(event: 'listening'): boolean;
270
- emit(event: 'checkContinue', req: IncomingMessage, res: ServerResponse): boolean;
271
- emit(event: 'checkExpectation', req: IncomingMessage, res: ServerResponse): boolean;
306
+ emit(
307
+ event: 'checkContinue',
308
+ req: InstanceType<Request>,
309
+ res: InstanceType<Response> & { req: InstanceType<Request> },
310
+ ): boolean;
311
+ emit(
312
+ event: 'checkExpectation',
313
+ req: InstanceType<Request>,
314
+ res: InstanceType<Response> & { req: InstanceType<Request> },
315
+ ): boolean;
272
316
  emit(event: 'clientError', err: Error, socket: stream.Duplex): boolean;
273
- emit(event: 'connect', req: IncomingMessage, socket: stream.Duplex, head: Buffer): boolean;
274
- emit(event: 'request', req: IncomingMessage, res: ServerResponse): boolean;
275
- emit(event: 'upgrade', req: IncomingMessage, socket: stream.Duplex, head: Buffer): boolean;
317
+ emit(event: 'connect', req: InstanceType<Request>, socket: stream.Duplex, head: Buffer): boolean;
318
+ emit(
319
+ event: 'request',
320
+ req: InstanceType<Request>,
321
+ res: InstanceType<Response> & { req: InstanceType<Request> },
322
+ ): boolean;
323
+ emit(event: 'upgrade', req: InstanceType<Request>, socket: stream.Duplex, head: Buffer): boolean;
276
324
  on(event: string, listener: (...args: any[]) => void): this;
277
325
  on(event: 'close', listener: () => void): this;
278
326
  on(event: 'connection', listener: (socket: Socket) => void): this;
279
327
  on(event: 'error', listener: (err: Error) => void): this;
280
328
  on(event: 'listening', listener: () => void): this;
281
- on(event: 'checkContinue', listener: RequestListener): this;
282
- on(event: 'checkExpectation', listener: RequestListener): this;
329
+ on(event: 'checkContinue', listener: RequestListener<Request, Response>): this;
330
+ on(event: 'checkExpectation', listener: RequestListener<Request, Response>): this;
283
331
  on(event: 'clientError', listener: (err: Error, socket: stream.Duplex) => void): this;
284
- on(event: 'connect', listener: (req: IncomingMessage, socket: stream.Duplex, head: Buffer) => void): this;
285
- on(event: 'request', listener: RequestListener): this;
286
- on(event: 'upgrade', listener: (req: IncomingMessage, socket: stream.Duplex, head: Buffer) => void): this;
332
+ on(event: 'connect', listener: (req: InstanceType<Request>, socket: stream.Duplex, head: Buffer) => void): this;
333
+ on(event: 'request', listener: RequestListener<Request, Response>): this;
334
+ on(event: 'upgrade', listener: (req: InstanceType<Request>, socket: stream.Duplex, head: Buffer) => void): this;
287
335
  once(event: string, listener: (...args: any[]) => void): this;
288
336
  once(event: 'close', listener: () => void): this;
289
337
  once(event: 'connection', listener: (socket: Socket) => void): this;
290
338
  once(event: 'error', listener: (err: Error) => void): this;
291
339
  once(event: 'listening', listener: () => void): this;
292
- once(event: 'checkContinue', listener: RequestListener): this;
293
- once(event: 'checkExpectation', listener: RequestListener): this;
340
+ once(event: 'checkContinue', listener: RequestListener<Request, Response>): this;
341
+ once(event: 'checkExpectation', listener: RequestListener<Request, Response>): this;
294
342
  once(event: 'clientError', listener: (err: Error, socket: stream.Duplex) => void): this;
295
- once(event: 'connect', listener: (req: IncomingMessage, socket: stream.Duplex, head: Buffer) => void): this;
296
- once(event: 'request', listener: RequestListener): this;
297
- once(event: 'upgrade', listener: (req: IncomingMessage, socket: stream.Duplex, head: Buffer) => void): this;
343
+ once(
344
+ event: 'connect',
345
+ listener: (req: InstanceType<Request>, socket: stream.Duplex, head: Buffer) => void,
346
+ ): this;
347
+ once(event: 'request', listener: RequestListener<Request, Response>): this;
348
+ once(
349
+ event: 'upgrade',
350
+ listener: (req: InstanceType<Request>, socket: stream.Duplex, head: Buffer) => void,
351
+ ): this;
298
352
  prependListener(event: string, listener: (...args: any[]) => void): this;
299
353
  prependListener(event: 'close', listener: () => void): this;
300
354
  prependListener(event: 'connection', listener: (socket: Socket) => void): this;
301
355
  prependListener(event: 'error', listener: (err: Error) => void): this;
302
356
  prependListener(event: 'listening', listener: () => void): this;
303
- prependListener(event: 'checkContinue', listener: RequestListener): this;
304
- prependListener(event: 'checkExpectation', listener: RequestListener): this;
357
+ prependListener(event: 'checkContinue', listener: RequestListener<Request, Response>): this;
358
+ prependListener(event: 'checkExpectation', listener: RequestListener<Request, Response>): this;
305
359
  prependListener(event: 'clientError', listener: (err: Error, socket: stream.Duplex) => void): this;
306
- prependListener(event: 'connect', listener: (req: IncomingMessage, socket: stream.Duplex, head: Buffer) => void): this;
307
- prependListener(event: 'request', listener: RequestListener): this;
308
- prependListener(event: 'upgrade', listener: (req: IncomingMessage, socket: stream.Duplex, head: Buffer) => void): this;
360
+ prependListener(
361
+ event: 'connect',
362
+ listener: (req: InstanceType<Request>, socket: stream.Duplex, head: Buffer) => void,
363
+ ): this;
364
+ prependListener(event: 'request', listener: RequestListener<Request, Response>): this;
365
+ prependListener(
366
+ event: 'upgrade',
367
+ listener: (req: InstanceType<Request>, socket: stream.Duplex, head: Buffer) => void,
368
+ ): this;
309
369
  prependOnceListener(event: string, listener: (...args: any[]) => void): this;
310
370
  prependOnceListener(event: 'close', listener: () => void): this;
311
371
  prependOnceListener(event: 'connection', listener: (socket: Socket) => void): this;
312
372
  prependOnceListener(event: 'error', listener: (err: Error) => void): this;
313
373
  prependOnceListener(event: 'listening', listener: () => void): this;
314
- prependOnceListener(event: 'checkContinue', listener: RequestListener): this;
315
- prependOnceListener(event: 'checkExpectation', listener: RequestListener): this;
374
+ prependOnceListener(event: 'checkContinue', listener: RequestListener<Request, Response>): this;
375
+ prependOnceListener(event: 'checkExpectation', listener: RequestListener<Request, Response>): this;
316
376
  prependOnceListener(event: 'clientError', listener: (err: Error, socket: stream.Duplex) => void): this;
317
- prependOnceListener(event: 'connect', listener: (req: IncomingMessage, socket: stream.Duplex, head: Buffer) => void): this;
318
- prependOnceListener(event: 'request', listener: RequestListener): this;
319
- prependOnceListener(event: 'upgrade', listener: (req: IncomingMessage, socket: stream.Duplex, head: Buffer) => void): this;
377
+ prependOnceListener(
378
+ event: 'connect',
379
+ listener: (req: InstanceType<Request>, socket: stream.Duplex, head: Buffer) => void,
380
+ ): this;
381
+ prependOnceListener(event: 'request', listener: RequestListener<Request, Response>): this;
382
+ prependOnceListener(
383
+ event: 'upgrade',
384
+ listener: (req: InstanceType<Request>, socket: stream.Duplex, head: Buffer) => void,
385
+ ): this;
320
386
  }
321
387
  /**
322
388
  * This class serves as the parent class of {@link ClientRequest} and {@link ServerResponse}. It is an abstract of outgoing message from
323
389
  * the perspective of the participants of HTTP transaction.
324
390
  * @since v0.1.17
325
391
  */
326
- class OutgoingMessage extends stream.Writable {
327
- readonly req: IncomingMessage;
392
+ class OutgoingMessage<Request extends IncomingMessage = IncomingMessage> extends stream.Writable {
393
+ readonly req: Request;
328
394
  chunkedEncoding: boolean;
329
395
  shouldKeepAlive: boolean;
330
396
  useChunkedEncodingByDefault: boolean;
@@ -461,7 +527,7 @@ declare module 'http' {
461
527
  * passed as the second parameter to the `'request'` event.
462
528
  * @since v0.1.17
463
529
  */
464
- class ServerResponse extends OutgoingMessage {
530
+ class ServerResponse<Request extends IncomingMessage = IncomingMessage> extends OutgoingMessage<Request> {
465
531
  /**
466
532
  * When using implicit headers (not calling `response.writeHead()` explicitly),
467
533
  * this property controls the status code that will be sent to the client when
@@ -491,7 +557,7 @@ declare module 'http' {
491
557
  * @since v0.11.8
492
558
  */
493
559
  statusMessage: string;
494
- constructor(req: IncomingMessage);
560
+ constructor(req: Request);
495
561
  assignSocket(socket: Socket): void;
496
562
  detachSocket(socket: Socket): void;
497
563
  /**
@@ -557,7 +623,11 @@ declare module 'http' {
557
623
  * will result in a `TypeError` being thrown.
558
624
  * @since v0.1.30
559
625
  */
560
- writeHead(statusCode: number, statusMessage?: string, headers?: OutgoingHttpHeaders | OutgoingHttpHeader[]): this;
626
+ writeHead(
627
+ statusCode: number,
628
+ statusMessage?: string,
629
+ headers?: OutgoingHttpHeaders | OutgoingHttpHeader[],
630
+ ): this;
561
631
  writeHead(statusCode: number, headers?: OutgoingHttpHeaders | OutgoingHttpHeader[]): this;
562
632
  /**
563
633
  * Sends a HTTP/1.1 102 Processing message to the client, indicating that
@@ -681,13 +751,19 @@ declare module 'http' {
681
751
  */
682
752
  getRawHeaderNames(): string[];
683
753
  addListener(event: 'abort', listener: () => void): this;
684
- addListener(event: 'connect', listener: (response: IncomingMessage, socket: Socket, head: Buffer) => void): this;
754
+ addListener(
755
+ event: 'connect',
756
+ listener: (response: IncomingMessage, socket: Socket, head: Buffer) => void,
757
+ ): this;
685
758
  addListener(event: 'continue', listener: () => void): this;
686
759
  addListener(event: 'information', listener: (info: InformationEvent) => void): this;
687
760
  addListener(event: 'response', listener: (response: IncomingMessage) => void): this;
688
761
  addListener(event: 'socket', listener: (socket: Socket) => void): this;
689
762
  addListener(event: 'timeout', listener: () => void): this;
690
- addListener(event: 'upgrade', listener: (response: IncomingMessage, socket: Socket, head: Buffer) => void): this;
763
+ addListener(
764
+ event: 'upgrade',
765
+ listener: (response: IncomingMessage, socket: Socket, head: Buffer) => void,
766
+ ): this;
691
767
  addListener(event: 'close', listener: () => void): this;
692
768
  addListener(event: 'drain', listener: () => void): this;
693
769
  addListener(event: 'error', listener: (err: Error) => void): this;
@@ -726,13 +802,19 @@ declare module 'http' {
726
802
  once(event: 'unpipe', listener: (src: stream.Readable) => void): this;
727
803
  once(event: string | symbol, listener: (...args: any[]) => void): this;
728
804
  prependListener(event: 'abort', listener: () => void): this;
729
- prependListener(event: 'connect', listener: (response: IncomingMessage, socket: Socket, head: Buffer) => void): this;
805
+ prependListener(
806
+ event: 'connect',
807
+ listener: (response: IncomingMessage, socket: Socket, head: Buffer) => void,
808
+ ): this;
730
809
  prependListener(event: 'continue', listener: () => void): this;
731
810
  prependListener(event: 'information', listener: (info: InformationEvent) => void): this;
732
811
  prependListener(event: 'response', listener: (response: IncomingMessage) => void): this;
733
812
  prependListener(event: 'socket', listener: (socket: Socket) => void): this;
734
813
  prependListener(event: 'timeout', listener: () => void): this;
735
- prependListener(event: 'upgrade', listener: (response: IncomingMessage, socket: Socket, head: Buffer) => void): this;
814
+ prependListener(
815
+ event: 'upgrade',
816
+ listener: (response: IncomingMessage, socket: Socket, head: Buffer) => void,
817
+ ): this;
736
818
  prependListener(event: 'close', listener: () => void): this;
737
819
  prependListener(event: 'drain', listener: () => void): this;
738
820
  prependListener(event: 'error', listener: (err: Error) => void): this;
@@ -741,13 +823,19 @@ declare module 'http' {
741
823
  prependListener(event: 'unpipe', listener: (src: stream.Readable) => void): this;
742
824
  prependListener(event: string | symbol, listener: (...args: any[]) => void): this;
743
825
  prependOnceListener(event: 'abort', listener: () => void): this;
744
- prependOnceListener(event: 'connect', listener: (response: IncomingMessage, socket: Socket, head: Buffer) => void): this;
826
+ prependOnceListener(
827
+ event: 'connect',
828
+ listener: (response: IncomingMessage, socket: Socket, head: Buffer) => void,
829
+ ): this;
745
830
  prependOnceListener(event: 'continue', listener: () => void): this;
746
831
  prependOnceListener(event: 'information', listener: (info: InformationEvent) => void): this;
747
832
  prependOnceListener(event: 'response', listener: (response: IncomingMessage) => void): this;
748
833
  prependOnceListener(event: 'socket', listener: (socket: Socket) => void): this;
749
834
  prependOnceListener(event: 'timeout', listener: () => void): this;
750
- prependOnceListener(event: 'upgrade', listener: (response: IncomingMessage, socket: Socket, head: Buffer) => void): this;
835
+ prependOnceListener(
836
+ event: 'upgrade',
837
+ listener: (response: IncomingMessage, socket: Socket, head: Buffer) => void,
838
+ ): this;
751
839
  prependOnceListener(event: 'close', listener: () => void): this;
752
840
  prependOnceListener(event: 'drain', listener: () => void): this;
753
841
  prependOnceListener(event: 'error', listener: (err: Error) => void): this;
@@ -1114,8 +1202,14 @@ declare module 'http' {
1114
1202
  * added to the `'request'` event.
1115
1203
  * @since v0.1.13
1116
1204
  */
1117
- function createServer(requestListener?: RequestListener): Server;
1118
- function createServer(options: ServerOptions, requestListener?: RequestListener): Server;
1205
+ function createServer<
1206
+ Request extends typeof IncomingMessage = typeof IncomingMessage,
1207
+ Response extends typeof ServerResponse = typeof ServerResponse,
1208
+ >(requestListener?: RequestListener<Request, Response>): Server<Request, Response>;
1209
+ function createServer<
1210
+ Request extends typeof IncomingMessage = typeof IncomingMessage,
1211
+ Response extends typeof ServerResponse = typeof ServerResponse,
1212
+ >(options: ServerOptions, requestListener?: RequestListener<Request, Response>): Server<Request, Response>;
1119
1213
  // although RequestOptions are passed as ClientRequestArgs to ClientRequest directly,
1120
1214
  // create interface RequestOptions would make the naming more clear to developers
1121
1215
  interface RequestOptions extends ClientRequestArgs {}
@@ -1304,7 +1398,11 @@ declare module 'http' {
1304
1398
  * @since v0.3.6
1305
1399
  */
1306
1400
  function request(options: RequestOptions | string | URL, callback?: (res: IncomingMessage) => void): ClientRequest;
1307
- function request(url: string | URL, options: RequestOptions, callback?: (res: IncomingMessage) => void): ClientRequest;
1401
+ function request(
1402
+ url: string | URL,
1403
+ options: RequestOptions,
1404
+ callback?: (res: IncomingMessage) => void,
1405
+ ): ClientRequest;
1308
1406
  /**
1309
1407
  * Since most requests are GET requests without bodies, Node.js provides this
1310
1408
  * convenience method. The only difference between this method and {@link request} is that it sets the method to GET and calls `req.end()`automatically. The callback must take care to consume the
node v16.11/http2.d.ts CHANGED
@@ -780,7 +780,7 @@ declare module 'http2' {
780
780
  * @since v8.4.0
781
781
  * @param callback Callback that is called once the session is connected or right away if the session is already connected.
782
782
  */
783
- settings(settings: Settings): void;
783
+ settings(settings: Settings, callback?: (err: Error | null, settings: Settings, duration: number) => void): void;
784
784
  /**
785
785
  * Calls `unref()` on this `Http2Session`instance's underlying `net.Socket`.
786
786
  * @since v9.4.0
node v16.11/https.d.ts CHANGED
@@ -8,7 +8,10 @@ declare module 'https' {
8
8
  import * as tls from 'node:tls';
9
9
  import * as http from 'node:http';
10
10
  import { URL } from 'node:url';
11
- type ServerOptions = tls.SecureContextOptions & tls.TlsOptions & http.ServerOptions;
11
+ type ServerOptions<
12
+ Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
13
+ Response extends typeof http.ServerResponse = typeof http.ServerResponse,
14
+ > = tls.SecureContextOptions & tls.TlsOptions & http.ServerOptions<Request, Response>;
12
15
  type RequestOptions = http.RequestOptions &
13
16
  tls.SecureContextOptions & {
14
17
  rejectUnauthorized?: boolean | undefined; // Defaults to true
@@ -26,35 +29,73 @@ declare module 'https' {
26
29
  constructor(options?: AgentOptions);
27
30
  options: AgentOptions;
28
31
  }
29
- interface Server extends http.Server {}
32
+ interface Server<
33
+ Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
34
+ Response extends typeof http.ServerResponse = typeof http.ServerResponse,
35
+ > extends http.Server<Request, Response> {}
30
36
  /**
31
37
  * See `http.Server` for more information.
32
38
  * @since v0.3.4
33
39
  */
34
- class Server extends tls.Server {
35
- constructor(requestListener?: http.RequestListener);
36
- constructor(options: ServerOptions, requestListener?: http.RequestListener);
40
+ class Server<
41
+ Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
42
+ Response extends typeof http.ServerResponse = typeof http.ServerResponse,
43
+ > extends tls.Server {
44
+ constructor(requestListener?: http.RequestListener<Request, Response>);
45
+ constructor(
46
+ options: ServerOptions<Request, Response>,
47
+ requestListener?: http.RequestListener<Request, Response>,
48
+ );
37
49
  addListener(event: string, listener: (...args: any[]) => void): this;
38
50
  addListener(event: 'keylog', listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
39
- addListener(event: 'newSession', listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void): this;
40
- addListener(event: 'OCSPRequest', listener: (certificate: Buffer, issuer: Buffer, callback: (err: Error | null, resp: Buffer) => void) => void): this;
41
- addListener(event: 'resumeSession', listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void): this;
51
+ addListener(
52
+ event: 'newSession',
53
+ listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
54
+ ): this;
55
+ addListener(
56
+ event: 'OCSPRequest',
57
+ listener: (
58
+ certificate: Buffer,
59
+ issuer: Buffer,
60
+ callback: (err: Error | null, resp: Buffer) => void,
61
+ ) => void,
62
+ ): this;
63
+ addListener(
64
+ event: 'resumeSession',
65
+ listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
66
+ ): this;
42
67
  addListener(event: 'secureConnection', listener: (tlsSocket: tls.TLSSocket) => void): this;
43
68
  addListener(event: 'tlsClientError', listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
44
69
  addListener(event: 'close', listener: () => void): this;
45
70
  addListener(event: 'connection', listener: (socket: Duplex) => void): this;
46
71
  addListener(event: 'error', listener: (err: Error) => void): this;
47
72
  addListener(event: 'listening', listener: () => void): this;
48
- addListener(event: 'checkContinue', listener: http.RequestListener): this;
49
- addListener(event: 'checkExpectation', listener: http.RequestListener): this;
73
+ addListener(event: 'checkContinue', listener: http.RequestListener<Request, Response>): this;
74
+ addListener(event: 'checkExpectation', listener: http.RequestListener<Request, Response>): this;
50
75
  addListener(event: 'clientError', listener: (err: Error, socket: Duplex) => void): this;
51
- addListener(event: 'connect', listener: (req: http.IncomingMessage, socket: Duplex, head: Buffer) => void): this;
52
- addListener(event: 'request', listener: http.RequestListener): this;
53
- addListener(event: 'upgrade', listener: (req: http.IncomingMessage, socket: Duplex, head: Buffer) => void): this;
76
+ addListener(
77
+ event: 'connect',
78
+ listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
79
+ ): this;
80
+ addListener(event: 'request', listener: http.RequestListener<Request, Response>): this;
81
+ addListener(
82
+ event: 'upgrade',
83
+ listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
84
+ ): this;
54
85
  emit(event: string, ...args: any[]): boolean;
55
86
  emit(event: 'keylog', line: Buffer, tlsSocket: tls.TLSSocket): boolean;
56
- emit(event: 'newSession', sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void): boolean;
57
- emit(event: 'OCSPRequest', certificate: Buffer, issuer: Buffer, callback: (err: Error | null, resp: Buffer) => void): boolean;
87
+ emit(
88
+ event: 'newSession',
89
+ sessionId: Buffer,
90
+ sessionData: Buffer,
91
+ callback: (err: Error, resp: Buffer) => void,
92
+ ): boolean;
93
+ emit(
94
+ event: 'OCSPRequest',
95
+ certificate: Buffer,
96
+ issuer: Buffer,
97
+ callback: (err: Error | null, resp: Buffer) => void,
98
+ ): boolean;
58
99
  emit(event: 'resumeSession', sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void): boolean;
59
100
  emit(event: 'secureConnection', tlsSocket: tls.TLSSocket): boolean;
60
101
  emit(event: 'tlsClientError', err: Error, tlsSocket: tls.TLSSocket): boolean;
@@ -62,80 +103,156 @@ declare module 'https' {
62
103
  emit(event: 'connection', socket: Duplex): boolean;
63
104
  emit(event: 'error', err: Error): boolean;
64
105
  emit(event: 'listening'): boolean;
65
- emit(event: 'checkContinue', req: http.IncomingMessage, res: http.ServerResponse): boolean;
66
- emit(event: 'checkExpectation', req: http.IncomingMessage, res: http.ServerResponse): boolean;
106
+ emit(
107
+ event: 'checkContinue',
108
+ req: InstanceType<Request>,
109
+ res: InstanceType<Response> & { req: InstanceType<Request> },
110
+ ): boolean;
111
+ emit(
112
+ event: 'checkExpectation',
113
+ req: InstanceType<Request>,
114
+ res: InstanceType<Response> & { req: InstanceType<Request> },
115
+ ): boolean;
67
116
  emit(event: 'clientError', err: Error, socket: Duplex): boolean;
68
- emit(event: 'connect', req: http.IncomingMessage, socket: Duplex, head: Buffer): boolean;
69
- emit(event: 'request', req: http.IncomingMessage, res: http.ServerResponse): boolean;
70
- emit(event: 'upgrade', req: http.IncomingMessage, socket: Duplex, head: Buffer): boolean;
117
+ emit(event: 'connect', req: InstanceType<Request>, socket: Duplex, head: Buffer): boolean;
118
+ emit(
119
+ event: 'request',
120
+ req: InstanceType<Request>,
121
+ res: InstanceType<Response> & { req: InstanceType<Request> },
122
+ ): boolean;
123
+ emit(event: 'upgrade', req: InstanceType<Request>, socket: Duplex, head: Buffer): boolean;
71
124
  on(event: string, listener: (...args: any[]) => void): this;
72
125
  on(event: 'keylog', listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
73
- on(event: 'newSession', listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void): this;
74
- on(event: 'OCSPRequest', listener: (certificate: Buffer, issuer: Buffer, callback: (err: Error | null, resp: Buffer) => void) => void): this;
75
- on(event: 'resumeSession', listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void): this;
126
+ on(
127
+ event: 'newSession',
128
+ listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
129
+ ): this;
130
+ on(
131
+ event: 'OCSPRequest',
132
+ listener: (
133
+ certificate: Buffer,
134
+ issuer: Buffer,
135
+ callback: (err: Error | null, resp: Buffer) => void,
136
+ ) => void,
137
+ ): this;
138
+ on(
139
+ event: 'resumeSession',
140
+ listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
141
+ ): this;
76
142
  on(event: 'secureConnection', listener: (tlsSocket: tls.TLSSocket) => void): this;
77
143
  on(event: 'tlsClientError', listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
78
144
  on(event: 'close', listener: () => void): this;
79
145
  on(event: 'connection', listener: (socket: Duplex) => void): this;
80
146
  on(event: 'error', listener: (err: Error) => void): this;
81
147
  on(event: 'listening', listener: () => void): this;
82
- on(event: 'checkContinue', listener: http.RequestListener): this;
83
- on(event: 'checkExpectation', listener: http.RequestListener): this;
148
+ on(event: 'checkContinue', listener: http.RequestListener<Request, Response>): this;
149
+ on(event: 'checkExpectation', listener: http.RequestListener<Request, Response>): this;
84
150
  on(event: 'clientError', listener: (err: Error, socket: Duplex) => void): this;
85
- on(event: 'connect', listener: (req: http.IncomingMessage, socket: Duplex, head: Buffer) => void): this;
86
- on(event: 'request', listener: http.RequestListener): this;
87
- on(event: 'upgrade', listener: (req: http.IncomingMessage, socket: Duplex, head: Buffer) => void): this;
151
+ on(event: 'connect', listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void): this;
152
+ on(event: 'request', listener: http.RequestListener<Request, Response>): this;
153
+ on(event: 'upgrade', listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void): this;
88
154
  once(event: string, listener: (...args: any[]) => void): this;
89
155
  once(event: 'keylog', listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
90
- once(event: 'newSession', listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void): this;
91
- once(event: 'OCSPRequest', listener: (certificate: Buffer, issuer: Buffer, callback: (err: Error | null, resp: Buffer) => void) => void): this;
92
- once(event: 'resumeSession', listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void): this;
156
+ once(
157
+ event: 'newSession',
158
+ listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
159
+ ): this;
160
+ once(
161
+ event: 'OCSPRequest',
162
+ listener: (
163
+ certificate: Buffer,
164
+ issuer: Buffer,
165
+ callback: (err: Error | null, resp: Buffer) => void,
166
+ ) => void,
167
+ ): this;
168
+ once(
169
+ event: 'resumeSession',
170
+ listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
171
+ ): this;
93
172
  once(event: 'secureConnection', listener: (tlsSocket: tls.TLSSocket) => void): this;
94
173
  once(event: 'tlsClientError', listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
95
174
  once(event: 'close', listener: () => void): this;
96
175
  once(event: 'connection', listener: (socket: Duplex) => void): this;
97
176
  once(event: 'error', listener: (err: Error) => void): this;
98
177
  once(event: 'listening', listener: () => void): this;
99
- once(event: 'checkContinue', listener: http.RequestListener): this;
100
- once(event: 'checkExpectation', listener: http.RequestListener): this;
178
+ once(event: 'checkContinue', listener: http.RequestListener<Request, Response>): this;
179
+ once(event: 'checkExpectation', listener: http.RequestListener<Request, Response>): this;
101
180
  once(event: 'clientError', listener: (err: Error, socket: Duplex) => void): this;
102
- once(event: 'connect', listener: (req: http.IncomingMessage, socket: Duplex, head: Buffer) => void): this;
103
- once(event: 'request', listener: http.RequestListener): this;
104
- once(event: 'upgrade', listener: (req: http.IncomingMessage, socket: Duplex, head: Buffer) => void): this;
181
+ once(event: 'connect', listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void): this;
182
+ once(event: 'request', listener: http.RequestListener<Request, Response>): this;
183
+ once(event: 'upgrade', listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void): this;
105
184
  prependListener(event: string, listener: (...args: any[]) => void): this;
106
185
  prependListener(event: 'keylog', listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
107
- prependListener(event: 'newSession', listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void): this;
108
- prependListener(event: 'OCSPRequest', listener: (certificate: Buffer, issuer: Buffer, callback: (err: Error | null, resp: Buffer) => void) => void): this;
109
- prependListener(event: 'resumeSession', listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void): this;
186
+ prependListener(
187
+ event: 'newSession',
188
+ listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
189
+ ): this;
190
+ prependListener(
191
+ event: 'OCSPRequest',
192
+ listener: (
193
+ certificate: Buffer,
194
+ issuer: Buffer,
195
+ callback: (err: Error | null, resp: Buffer) => void,
196
+ ) => void,
197
+ ): this;
198
+ prependListener(
199
+ event: 'resumeSession',
200
+ listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
201
+ ): this;
110
202
  prependListener(event: 'secureConnection', listener: (tlsSocket: tls.TLSSocket) => void): this;
111
203
  prependListener(event: 'tlsClientError', listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
112
204
  prependListener(event: 'close', listener: () => void): this;
113
205
  prependListener(event: 'connection', listener: (socket: Duplex) => void): this;
114
206
  prependListener(event: 'error', listener: (err: Error) => void): this;
115
207
  prependListener(event: 'listening', listener: () => void): this;
116
- prependListener(event: 'checkContinue', listener: http.RequestListener): this;
117
- prependListener(event: 'checkExpectation', listener: http.RequestListener): this;
208
+ prependListener(event: 'checkContinue', listener: http.RequestListener<Request, Response>): this;
209
+ prependListener(event: 'checkExpectation', listener: http.RequestListener<Request, Response>): this;
118
210
  prependListener(event: 'clientError', listener: (err: Error, socket: Duplex) => void): this;
119
- prependListener(event: 'connect', listener: (req: http.IncomingMessage, socket: Duplex, head: Buffer) => void): this;
120
- prependListener(event: 'request', listener: http.RequestListener): this;
121
- prependListener(event: 'upgrade', listener: (req: http.IncomingMessage, socket: Duplex, head: Buffer) => void): this;
211
+ prependListener(
212
+ event: 'connect',
213
+ listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
214
+ ): this;
215
+ prependListener(event: 'request', listener: http.RequestListener<Request, Response>): this;
216
+ prependListener(
217
+ event: 'upgrade',
218
+ listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
219
+ ): this;
122
220
  prependOnceListener(event: string, listener: (...args: any[]) => void): this;
123
221
  prependOnceListener(event: 'keylog', listener: (line: Buffer, tlsSocket: tls.TLSSocket) => void): this;
124
- prependOnceListener(event: 'newSession', listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void): this;
125
- prependOnceListener(event: 'OCSPRequest', listener: (certificate: Buffer, issuer: Buffer, callback: (err: Error | null, resp: Buffer) => void) => void): this;
126
- prependOnceListener(event: 'resumeSession', listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void): this;
222
+ prependOnceListener(
223
+ event: 'newSession',
224
+ listener: (sessionId: Buffer, sessionData: Buffer, callback: (err: Error, resp: Buffer) => void) => void,
225
+ ): this;
226
+ prependOnceListener(
227
+ event: 'OCSPRequest',
228
+ listener: (
229
+ certificate: Buffer,
230
+ issuer: Buffer,
231
+ callback: (err: Error | null, resp: Buffer) => void,
232
+ ) => void,
233
+ ): this;
234
+ prependOnceListener(
235
+ event: 'resumeSession',
236
+ listener: (sessionId: Buffer, callback: (err: Error, sessionData: Buffer) => void) => void,
237
+ ): this;
127
238
  prependOnceListener(event: 'secureConnection', listener: (tlsSocket: tls.TLSSocket) => void): this;
128
239
  prependOnceListener(event: 'tlsClientError', listener: (err: Error, tlsSocket: tls.TLSSocket) => void): this;
129
240
  prependOnceListener(event: 'close', listener: () => void): this;
130
241
  prependOnceListener(event: 'connection', listener: (socket: Duplex) => void): this;
131
242
  prependOnceListener(event: 'error', listener: (err: Error) => void): this;
132
243
  prependOnceListener(event: 'listening', listener: () => void): this;
133
- prependOnceListener(event: 'checkContinue', listener: http.RequestListener): this;
134
- prependOnceListener(event: 'checkExpectation', listener: http.RequestListener): this;
244
+ prependOnceListener(event: 'checkContinue', listener: http.RequestListener<Request, Response>): this;
245
+ prependOnceListener(event: 'checkExpectation', listener: http.RequestListener<Request, Response>): this;
135
246
  prependOnceListener(event: 'clientError', listener: (err: Error, socket: Duplex) => void): this;
136
- prependOnceListener(event: 'connect', listener: (req: http.IncomingMessage, socket: Duplex, head: Buffer) => void): this;
137
- prependOnceListener(event: 'request', listener: http.RequestListener): this;
138
- prependOnceListener(event: 'upgrade', listener: (req: http.IncomingMessage, socket: Duplex, head: Buffer) => void): this;
247
+ prependOnceListener(
248
+ event: 'connect',
249
+ listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
250
+ ): this;
251
+ prependOnceListener(event: 'request', listener: http.RequestListener<Request, Response>): this;
252
+ prependOnceListener(
253
+ event: 'upgrade',
254
+ listener: (req: InstanceType<Request>, socket: Duplex, head: Buffer) => void,
255
+ ): this;
139
256
  }
140
257
  /**
141
258
  * ```js
@@ -174,8 +291,17 @@ declare module 'https' {
174
291
  * @param options Accepts `options` from `createServer`, `createSecureContext` and `createServer`.
175
292
  * @param requestListener A listener to be added to the `'request'` event.
176
293
  */
177
- function createServer(requestListener?: http.RequestListener): Server;
178
- function createServer(options: ServerOptions, requestListener?: http.RequestListener): Server;
294
+ function createServer<
295
+ Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
296
+ Response extends typeof http.ServerResponse = typeof http.ServerResponse,
297
+ >(requestListener?: http.RequestListener<Request, Response>): Server<Request, Response>;
298
+ function createServer<
299
+ Request extends typeof http.IncomingMessage = typeof http.IncomingMessage,
300
+ Response extends typeof http.ServerResponse = typeof http.ServerResponse,
301
+ >(
302
+ options: ServerOptions<Request, Response>,
303
+ requestListener?: http.RequestListener<Request, Response>,
304
+ ): Server<Request, Response>;
179
305
  /**
180
306
  * Makes a request to a secure web server.
181
307
  *
@@ -356,8 +482,15 @@ declare module 'https' {
356
482
  * @since v0.3.6
357
483
  * @param options Accepts all `options` from `request`, with some differences in default values:
358
484
  */
359
- function request(options: RequestOptions | string | URL, callback?: (res: http.IncomingMessage) => void): http.ClientRequest;
360
- function request(url: string | URL, options: RequestOptions, callback?: (res: http.IncomingMessage) => void): http.ClientRequest;
485
+ function request(
486
+ options: RequestOptions | string | URL,
487
+ callback?: (res: http.IncomingMessage) => void,
488
+ ): http.ClientRequest;
489
+ function request(
490
+ url: string | URL,
491
+ options: RequestOptions,
492
+ callback?: (res: http.IncomingMessage) => void,
493
+ ): http.ClientRequest;
361
494
  /**
362
495
  * Like `http.get()` but for HTTPS.
363
496
  *
@@ -382,8 +515,15 @@ declare module 'https' {
382
515
  * @since v0.3.6
383
516
  * @param options Accepts the same `options` as {@link request}, with the `method` always set to `GET`.
384
517
  */
385
- function get(options: RequestOptions | string | URL, callback?: (res: http.IncomingMessage) => void): http.ClientRequest;
386
- function get(url: string | URL, options: RequestOptions, callback?: (res: http.IncomingMessage) => void): http.ClientRequest;
518
+ function get(
519
+ options: RequestOptions | string | URL,
520
+ callback?: (res: http.IncomingMessage) => void,
521
+ ): http.ClientRequest;
522
+ function get(
523
+ url: string | URL,
524
+ options: RequestOptions,
525
+ callback?: (res: http.IncomingMessage) => void,
526
+ ): http.ClientRequest;
387
527
  let globalAgent: Agent;
388
528
  }
389
529
  declare module 'node:https' {
node v16.11/net.d.ts CHANGED
@@ -54,6 +54,9 @@ declare module 'net' {
54
54
  hints?: number | undefined;
55
55
  family?: number | undefined;
56
56
  lookup?: LookupFunction | undefined;
57
+ noDelay?: boolean | undefined;
58
+ keepAlive?: boolean | undefined;
59
+ keepAliveInitialDelay?: number | undefined;
57
60
  }
58
61
  interface IpcSocketConnectOpts extends ConnectOpts {
59
62
  path: string;
@@ -399,6 +402,25 @@ declare module 'net' {
399
402
  * @default false
400
403
  */
401
404
  pauseOnConnect?: boolean | undefined;
405
+ /**
406
+ * If set to `true`, it disables the use of Nagle's algorithm immediately after a new incoming connection is received.
407
+ * @default false
408
+ * @since v16.5.0
409
+ */
410
+ noDelay?: boolean | undefined;
411
+ /**
412
+ * If set to `true`, it enables keep-alive functionality on the socket immediately after a new incoming connection is received,
413
+ * similarly on what is done in `socket.setKeepAlive([enable][, initialDelay])`.
414
+ * @default false
415
+ * @since v16.5.0
416
+ */
417
+ keepAlive?: boolean | undefined;
418
+ /**
419
+ * If set to a positive number, it sets the initial delay before the first keepalive probe is sent on an idle socket.
420
+ * @default 0
421
+ * @since v16.5.0
422
+ */
423
+ keepAliveInitialDelay?: number | undefined;
402
424
  }
403
425
  /**
404
426
  * This class is used to create a TCP or `IPC` server.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@types/node",
3
- "version": "16.11.55",
3
+ "version": "16.11.58",
4
4
  "description": "TypeScript definitions for Node.js",
5
5
  "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
6
6
  "license": "MIT",
@@ -220,6 +220,6 @@
220
220
  },
221
221
  "scripts": {},
222
222
  "dependencies": {},
223
- "typesPublisherContentHash": "34fd4a12bcb0e6691bcda03a9b043e62af3bd45fdb632f098b72433cd011731b",
224
- "typeScriptVersion": "4.0"
223
+ "typesPublisherContentHash": "be106dd067eddfded19382dbba47c191f861c92840693ae27bddb20bc1fe359a",
224
+ "typeScriptVersion": "4.1"
225
225
  }