大网数据广告活动
Web 标准与前端开发

WebTransportDatagramDuplexStream: outgoingMaxBufferedDatagrams property

· 52CE 我爱测

The **`outgoingMaxBufferedDatagrams`** property of the WebTransportDatagramDuplexStream interface represents the maximum number of outgoing datagrams that can be queued for sending on each WebTransportDatagramsWritable before backpressure is applied.

WebTransport API

The outgoingMaxBufferedDatagrams property of the WebTransportDatagramDuplexStream interface represents the maximum number of outgoing datagrams that can be queued for sending on each WebTransportDatagramsWritable before backpressure is applied.

Value

An integer.

The initial value is defined by the browser. Setting the property to 0 sets it to 1.

Description

Each WebTransportDatagramsWritable returned by WebTransportDatagramDuplexStream.createWritable has its own queue of datagrams waiting to be sent. When the number of datagrams in a queue reaches this value, the writable applies backpressure: the promise returned by the writer's WritableStreamDefaultWriter.write() method, and its WritableStreamDefaultWriter.ready promise, don't fulfill until there is room in the queue for another datagram. Queued datagrams are not dropped because the queue is full, though they can still expire if WebTransportDatagramDuplexStream.outgoingMaxAge is set.

Increasing this value releases backpressure on any writable whose queue is now shorter than the new value.

This property replaces the deprecated WebTransportDatagramDuplexStream.outgoingHighWaterMark property.

Examples

Setting the maximum number of buffered outgoing datagrams

This example sets the outgoing queue of each writable to hold up to 100 datagrams, and then logs the value.

const url = "https://example.com:4999/wt";

async function initTransport(url) {
  // Initialize transport connection
  const transport = new WebTransport(url);

  // The connection can be used once ready fulfills
  await transport.ready;

  const datagrams = transport.datagrams;

  // set outgoingMaxBufferedDatagrams
  datagrams.outgoingMaxBufferedDatagrams = 100;

  // get outgoingMaxBufferedDatagrams
  console.log(datagrams.outgoingMaxBufferedDatagrams);
}

Specifications

Browser compatibility

See also

  • WebTransportDatagramDuplexStream.createWritable()
  • WebTransportDatagramDuplexStream.outgoingMaxAge
  • WebTransportDatagramDuplexStream.incomingMaxBufferedDatagrams
  • Using WebTransport
  • Streams API

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。