Http1ServerConnection
Defined in: packages/net-http/src/h1/http1-server-connection.ts:91
Serves HTTP/1.x on one connection: decodes requests in order, runs the
handler for each, writes its response, keeps the connection alive between
requests when both sides allow it, and hands it over on an accepted Upgrade
or CONNECT.
Requests are handled one at a time even when pipelined, since HTTP/1.1 responses must leave in request order. Receiving stops while a request is handled, so pipelined requests cannot queue beyond what one read delivered.
A response sent before its request body was read to the end closes the connection afterwards rather than draining an unbounded body.
Use HttpServer to accept connections; this class is the per- connection piece, for custom servers and tests.
Extends
Section titled “Extends”EventDispatcherMapBase<Http1ServerConnectionEvents>
Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new Http1ServerConnection(
options):Http1ServerConnection
Defined in: packages/net-http/src/h1/http1-server-connection.ts:104
Parameters
Section titled “Parameters”options
Section titled “options”Returns
Section titled “Returns”Http1ServerConnection
Overrides
Section titled “Overrides”EventDispatcherMapBase<Http1ServerConnectionEvents>.constructor
Accessors
Section titled “Accessors”Get Signature
Section titled “Get Signature”get idle():
boolean
Defined in: packages/net-http/src/h1/http1-server-connection.ts:129
Whether no request is being handled or waiting to be.
Returns
Section titled “Returns”boolean
Methods
Section titled “Methods”close()
Section titled “close()”close():
Promise<void>
Defined in: packages/net-http/src/h1/http1-server-connection.ts:139
Finish the request being handled, if any, then close. Requests not yet started are dropped.
Returns
Section titled “Returns”Promise<void>
Resolves once the connection closed.
destroy()
Section titled “destroy()”destroy(
error?):void
Defined in: packages/net-http/src/h1/http1-server-connection.ts:148
Close at once, aborting the request being handled.
Parameters
Section titled “Parameters”error?
Section titled “error?”unknown
Returns
Section titled “Returns”void
isSubscribed()
Section titled “isSubscribed()”isSubscribed<
K>(event,listener):boolean
Defined in: packages/async/src/events/event-dispatcher-map-base.ts:38
Check if a callback is subscribed to a specific event.
Type Parameters
Section titled “Type Parameters”K extends keyof Http1ServerConnectionEvents
Parameters
Section titled “Parameters”K
The event name.
listener
Section titled “listener”Callable<Http1ServerConnectionEvents[K]>
The callback to check.
Returns
Section titled “Returns”boolean
Inherited from
Section titled “Inherited from”EventDispatcherMapBase.isSubscribed
subscribe()
Section titled “subscribe()”subscribe<
K>(event,listener,options?):Callable|null
Defined in: packages/async/src/events/event-dispatcher-map-base.ts:23
Type Parameters
Section titled “Type Parameters”K extends keyof Http1ServerConnectionEvents
Parameters
Section titled “Parameters”K
listener
Section titled “listener”Callable<Http1ServerConnectionEvents[K]>
options?
Section titled “options?”EventDispatcherSubscribeOptions
Returns
Section titled “Returns”Callable | null
Inherited from
Section titled “Inherited from”EventDispatcherMapBase.subscribe
unsubscribe()
Section titled “unsubscribe()”unsubscribe<
K>(event,listener):void
Defined in: packages/async/src/events/event-dispatcher-map-base.ts:31
Unsubscribe a callback from a specific event.
Type Parameters
Section titled “Type Parameters”K extends keyof Http1ServerConnectionEvents
Parameters
Section titled “Parameters”K
The event name.
listener
Section titled “listener”Callable<Http1ServerConnectionEvents[K]>
The callback to remove.
Returns
Section titled “Returns”void
Inherited from
Section titled “Inherited from”EventDispatcherMapBase.unsubscribe
wait()
Section titled “wait()”wait<
K>(event,options?):Promise<Http1ServerConnectionEvents[K]>
Defined in: packages/async/src/events/event-dispatcher-map-base.ts:45
Wait for the next occurrence of a specific event, optionally matching a predicate.
This is a convenience method that subscribes to the dispatcher, waits for the next event that matches the predicate (if provided), and then unsubscribes automatically.
Type Parameters
Section titled “Type Parameters”K extends keyof Http1ServerConnectionEvents
Parameters
Section titled “Parameters”K
The event name to wait for.
options?
Section titled “options?”EventDispatcherWaitOptions<Http1ServerConnectionEvents[K]>
Optional settings including predicate and abort signal.
Returns
Section titled “Returns”Promise<Http1ServerConnectionEvents[K]>
A promise that resolves with the event arguments as an array.
Inherited from
Section titled “Inherited from”EventDispatcherMapBase.wait