WebTransport:incomingBidirectionalStreams 属性

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

注意:此功能在 Web Workers 中可用。

WebTransport 接口的只读属性 incomingBidirectionalStreams 表示服务器打开的一个或多个双向流。它返回一个 ReadableStream 对象,其中包含 WebTransportBidirectionalStream 对象。每个对象都可以用来可靠地从服务器读取数据并向其写回数据。

“可靠”意味着保证数据的传输顺序。这提供了比 datagrams 更慢的传输速度(尽管比 WebSockets 快),但在可靠性和顺序性至关重要的情况下是必需的,例如聊天应用程序。

一个包含 WebTransportBidirectionalStream 对象的 ReadableStream

示例

使用一个初始函数从 ReadableStream 中读取 WebTransportBidirectionalStream 对象。对于每个对象,会将 WebTransportBidirectionalStream.readableWebTransportBidirectionalStream.writable 值传递给其他函数,以便对这些流进行读写操作。

js
async function receiveBidirectional() {
  const bds = transport.incomingBidirectionalStreams;
  const reader = bds.getReader();
  while (true) {
    const { done, value } = await reader.read();
    if (done) {
      break;
    }
    // value is an instance of WebTransportBidirectionalStream
    await readData(value.readable);
    await writeData(value.writable);
  }
}

async function readData(readable) {
  const reader = readable.getReader();
  while (true) {
    const { value, done } = await reader.read();
    if (done) {
      break;
    }
    // value is a Uint8Array.
    console.log(value);
  }
}

async function writeData(writable) {
  const writer = writable.getWriter();
  const data1 = new Uint8Array([65, 66, 67]);
  const data2 = new Uint8Array([68, 69, 70]);
  writer.write(data1);
  writer.write(data2);
}

规范

规范
WebTransport
# dom-webtransport-incomingbidirectionalstreams

浏览器兼容性

另见