HTTP2 client 
[![NPM Version][npm-image]][npm-url]
Drop-in replacement for Nodes http and https that transparently make http request to both http1 / http2 server.
Motivation http2 in Node.JS works entirely differently, while in browsers the experience is the same.
http2-client was created to enable http2 / http1.1 requests with the same interface as http1.1.
The reason is that many NPM modules cannot upgrade to use http2.0 as these are coupled into http1.1 interface.http2-client it should be very straight forward.
Meaning you don't need to know which protocol the destination supports before making the request http2-client will chose the one that works.
If the Node.js version you are using is not supporting http2 http2-client will automatically fallback to http.
Features Transparently supports all http protocol.
* Http/1.1
* Https/1.1
* Http/2.0
In case of http1.1
In case of http2.0
Usage - Same interface $3 ``
jsUrl : ${h1Target}
Status : ${res.statusCode}
HttpVersion : ${res.httpVersion}
);const req2 = request(h2Target, (res)=>{
Url : ${h2Target}
Status : ${res.statusCode}
HttpVersion : ${res.httpVersion}
);`
$3 `
jsUrl : ${h1Target}
Status : ${res.statusCode}
HttpVersion : ${res.httpVersion}
);get(h2Target, (res)=>{
Url : ${h2Target}
Status : ${res.statusCode}
HttpVersion : ${res.httpVersion}
);`
API
$3 Time to keep http2 connection after used last time. Default: 1000ms. TTL time for identification results of http1.1. Default: 30000ms. Should enforce http socket. Should enforce https socket.`js.... /);//Alternatively create a new request.... /);
`
$3 | | Protocol to use. Default: 'http:'. A domain name or IP address of the server to issue the request to. Default: 'localhost'. Alias for host. To support url.parse(), hostname is preferred over host. IP address family to use when resolving host and hostname. Valid values are 4 or 6.When unspecified, both IP v4 and v6 will be used. Port of remote server. Default: 80. Local interface to bind for network connections. Unix Domain Socket (use one of host:port or socketPath). A string specifying the HTTP request method. Default: 'GET'. Request path. Should include query string if any. E.G. '/index.html?page=12'. An exception is thrown when the request path contains illegal characters. Currently, only spaces are rejected but that may change in the future. Default: '/'. An object containing request headers. Basic authentication i.e. 'user:password' to compute an Authorization header. | Controls Agent behavior. Possible values: A function that produces a socket/stream to use for the request when the agent option is not used. This can be used to avoid creating a custom Agent class just to override the default createConnection function. See agent.createConnection() for more details. Any Duplex stream is a valid return value. : A number specifying the socket timeout in milliseconds. This will set the timeout before the socket is connected.: Specifies whether or not to automatically add the Host header. Defaults to true.
$3
$3 | | Accepts all options from Http/1.1 , with some differences in default values and aditional tls options: If not false, the server certificate is verified against the list of supplied CAs. An 'error' event is emitted if verification fails; err.code contains the OpenSSL error code. Default: true. | | | | An array of strings, Buffers or Uint8Arrays, or a single Buffer or Uint8Array containing the supported ALPN protocols. Buffers should have the format [len][name][len][name]... e.g. 0x05hello0x05world, where the first byte is the length of the next protocol name. Passing an array is usually much simpler, e.g. ['hello', 'world']. Server name for the SNI (Server Name Indication) TLS extension. A callback function to be used (instead of the builtin tls.checkServerIdentity() function) when checking the server's hostname (or the provided servername when explicitly set) against the certificate. This should return an if verification fails. The method should return undefined if the servername and cert are verified. A Buffer instance, containing TLS session. Minimum size of the DH parameter in bits to accept a TLS connection. When a server offers a DH parameter with a size less than minDHSize, the TLS connection is destroyed and an error is thrown. Default: 1024. Custom lookup function. Default: dns.lookup().
$3 | | Accepts all options from Https/1.1
How? implements 'Application-Layer Protocol Negotiation (ALPN)'.If the supported protocol is http2.0
http2-client will re-use the same connection.keepH2ConnectionFor which defaults to 100 ms, it will be automatically closed.If the supported protocol is http1.x
http2-client will only cache the identification result and not the actual socket for keepH1IdentificationCacheFor which defaults to 30000 ms.globalAgent` will be used.
License MIT
[npm-image]: https://img.shields.io/npm/v/http2-client.svg