HTTP/2 transport for unireq using Node.js http2 module
npm install @unireq/http2
Dedicated HTTP/2 transport powered by Node's http2 module. Use it when you need strict HTTP/2 semantics (multiplexing, server push, explicit ALPN) instead of the default Undici-based HTTP/1.1 transport.
``bash`
pnpm add @unireq/http2
`typescript
import { client, retry, backoff } from '@unireq/core';
import { http2, Http2Connector } from '@unireq/http2';
const h2 = client(
http2('https://h2.example.com', new Http2Connector({ sessionTimeout: 45_000 })),
retry(undefined, [backoff()], { tries: 3 }),
);
const resp = await h2.get('/products');
`
| Export | Description |
| --- | --- |
| http2(uri?, connector?) | Returns a transport with streams, http2, serverPush capabilities |Http2Connector
| | Default connector with ALPN negotiation, session caching, graceful teardown |Http2ConnectorOptions
| | { enablePush?, sessionTimeout? } configuration |
- Pass http2('https://api.example.com') to prefix relative paths with the base
- Without a base URI, all URLs must be absolute
- The first request lazily establishes a session; subsequent requests reuse it
`typescript
class InstrumentedConnector extends Http2Connector {
async request(client, ctx) {
const start = performance.now();
try {
return await super.request(client, ctx);
} finally {
metrics.timing('http2.duration', performance.now() - start);
}
}
}
const api = client(http2('https://api.internal', new InstrumentedConnector()));
`
- Connection failures, GOAWAY frames, and request timeouts bubble up as rejected promises
- Wrap the transport with retry/backoff` for resilience
- The connector automatically removes broken sessions from cache
Full documentation available at unireq.dev
MIT