typings: add JSDoc typings for http

PR-URL: #38191 Reviewed-By: Bradley Farias <[email protected]> Reviewed-By: Michaël Zasso <[email protected]>

Author: VoltrexKeyva

lib/http.js

@@ -44,14 +44,65 @@ const{
 }=require('_http_server');
 letmaxHeaderSize;
 
+/**
+ * Returns a new instance of `http.Server`.
+ * @param{{
+ * IncomingMessage?: IncomingMessage;
+ * ServerResponse?: ServerResponse;
+ * insecureHTTPParser?: boolean;
+ * maxHeaderSize?: number;
+ * }} [opts]
+ * @param{Function} [requestListener]
+ * @returns{Server}
+ */
 functioncreateServer(opts,requestListener){
 returnnewServer(opts,requestListener);
 }
 
+/**
+ * @typedef{Object} HTTPRequestOptions
+ * @property{httpAgent.Agent | boolean} [agent]
+ * @property{string} [auth]
+ * @property{Function} [createConnection]
+ * @property{number} [defaultPort]
+ * @property{number} [family]
+ * @property{Object} [headers]
+ * @property{number} [hints]
+ * @property{string} [host]
+ * @property{string} [hostname]
+ * @property{boolean} [insecureHTTPParser]
+ * @property{string} [localAddress]
+ * @property{number} [localPort]
+ * @property{Function} [lookup]
+ * @property{number} [maxHeaderSize]
+ * @property{string} [method]
+ * @property{string} [path]
+ * @property{number} [port]
+ * @property{string} [protocol]
+ * @property{boolean} [setHost]
+ * @property{string} [socketPath]
+ * @property{number} [timeout]
+ * @property{AbortSignal} [signal]
+ */
+
+/**
+ * Makes an HTTP request.
+ * @param{string | URL} url
+ * @param{HTTPRequestOptions} [options]
+ * @param{Function} [cb]
+ * @returns{ClientRequest}
+ */
 functionrequest(url,options,cb){
 returnnewClientRequest(url,options,cb);
 }
 
+/**
+ * Makes a `GET` HTTP request.
+ * @param{string | URL} url
+ * @param{HTTPRequestOptions} [options]
+ * @param{Function} [cb]
+ * @returns{ClientRequest}
+ */
 functionget(url,options,cb){
 constreq=request(url,options,cb);
 req.end();