Wait until the peer creates a new bidirectional stream.
Wait until the peer creates a new unidirectional stream.
Will error if the session has been closed.
Close the session immediately.
Pending operations will fail immediately with a LocallyClosed error. No more data is sent
to the peer beyond a CONNECTION_CLOSE frame, and the peer may drop buffered data upon
receiving the CONNECTION_CLOSE frame.
code and reason are not interpreted, and are provided directly to the peer.
reason will be truncated to fit in a single packet with overhead; to improve odds that it
is preserved in full, it should be kept under 1KiB.
Only the peer last receiving application data can be certain that all data is delivered.
The only reliable action it can then take is to close the session, potentially with a
custom error code. The delivery of the final CONNECTION_CLOSE frame is very likely if
both endpoints stay online long enough, and endpoint.wait_idle() can be used to provide
sufficient time. Otherwise, the remote peer will time out the session after 30 seconds.
The sending side can not guarantee all stream data is delivered to the remote application.
It only knows the data is delivered to the QUIC stack of the remote endpoint. Once the
local side sends a CONNECTION_CLOSE frame, the remote endpoint may drop any data it
received but is as yet undelivered to the application, including data that was acknowledged
as received to the local endpoint.
Wait until the connection is closed.
Returns null if the connection was closed locally, and a string if the connection
was closed by a peer (e.g. with close()). Throws for other unexpected close reasons.
The maximum size of a datagram that can be sent.
Open a new bidirectional stream.
May wait when there are too many concurrent streams.
Open a new unidirectional stream.
May wait when there are too many concurrent streams.
The public key of the remote peer.
This may be unavailable if requireClientAuth was set to false in the Allower.
Receive a datagram over the network.
Send an unreliable datagram over the network.
QUIC datagrams may be dropped for any reason, including (non-exhaustive):
max_datagram_size()
A Session, able to accept/create streams and send/recv datagrams.
If all references to a session have been dropped, then the session will be automatically closed with a
codeof 0 and an empty reason. You can also close the session explicitly by callingsession.close().Closing the session immediately sends a
CONNECTION_CLOSEframe and then abandons efforts to deliver data to the peer. Upon receiving aCONNECTION_CLOSEframe, the peer may drop any stream data not yet delivered to the application.session.close()describes in more detail how to gracefully close a session without losing application data.