WebTransportSendStream
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is available in Web Workers.
The WebTransportSendStream
interface of the WebTransport API is a specialized WritableStream
that is used to send outbound data in both unidirectional or bidirectional WebTransport
streams.
The send stream is a writable stream of Uint8Array
, that can be written to in order to send data to a server.
It additionally provides streaming features such as setting the send order, and getting stream statistics.
Objects of this type are not constructed directly.
When creating a unidirectional stream the WebTransport.createUnidirectionalStream()
returns an object of this type for sending data.
When creating a bidirectional stream using WebTransport.createBidirectionalStream()
, the method returns a WebTransportBidirectionalStream
, and the send stream object can be obtained from its writable
property.
When a bidirectional stream is initiated by the remote end, an object of this type can similarly be obtained using WebTransport.incomingBidirectionalStreams
.
WebTransportSendStream
is a transferable object.
Instance properties
Also inherits properties from its parent interface, WritableStream
.
WebTransportSendStream.getStats()
Experimental-
Returns a
Promise
that resolves with statistics related to this stream.
Instance methods
Also inherits methods from its parent interface, WritableStream
.
WebTransportSendStream.sendOrder
Experimental-
Indicates the send priority of this stream relative to other streams for which the value has been set.
Examples
See WebTransport.incomingUnidirectionalStreams
for an example of how to get a ReadableStream
of WebTransportSendStream
objects.
Specifications
Specification |
---|
WebTransport # webtransportsendstream |
Browser compatibility
BCD tables only load in the browser