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

WebTransport

· 52CE 我爱测

WebTransport API 的 **`WebTransport`** 接口提供了使用户代理能够连接到 HTTP/3 服务器,启动(单向或双向的)可靠和不可靠传输,并在不再需要时关闭连接的功能。

WebTransport API

WebTransport API 的 WebTransport 接口提供了使用户代理能够连接到 HTTP/3 服务器,启动(单向或双向的)可靠和不可靠传输,并在不再需要时关闭连接的功能。

构造函数

  • WebTransport.WebTransport
    • : 创建新的 WebTransport 对象实例。

实例属性

  • WebTransport.closed
    • : 返回一个在传输关闭时兑现的 promise。
  • WebTransport.datagrams
    • : 返回一个可用于发送和接收数据报的 WebTransportDatagramDuplexStream 实例。
  • WebTransport.congestionControl
    • : 返回一个指示应用程序在发送数据时对高吞吐量或低延迟的偏好的字符串。
  • WebTransport.incomingBidirectionalStreams
    • : 表示服务器打开的一个或多个双向流。返回 WebTransportBidirectionalStream 对象(每个对象都可以用于从服务器读取数据并将数据写回服务器)的 ReadableStream。
  • WebTransport.incomingUnidirectionalStreams
    • : 表示服务器打开的一个或多个单向流。返回 WebTransportReceiveStream 对象(每个对象都可以用于从服务器读取数据)的 ReadableStream。
  • WebTransport.ready
    • : 返回一个会在传输准备就绪时兑现的 promise。
  • WebTransport.reliability
    • : 返回一个指示连接是否仅支持可靠传输,或者它是否还支持不可靠传输(例如 UDP)的字符串。

实例方法

  • WebTransport.close
    • : 关闭正在进行的 WebTransport 会话。
  • WebTransport.createBidirectionalStream
    • : 异步打开一个双向流(WebTransportBidirectionalStream),该流可用于从服务器读取数据并将数据写回服务器。
  • WebTransport.createUnidirectionalStream
    • : 异步打开一个单向流(WebTransportSendStream),该流可用于向服务器写入数据。
  • WebTransport.getStats
    • : 异步返回一个 Promise,其会兑现一个包含 HTTP/3 连接统计信息的对象。

示例

以下示例代码展示了如何将 HTTP/3 服务器的 URL 传递给 WebTransport.WebTransport 构造函数以连接到该服务器。注意,方案需要是 HTTPS,且需要明确指定端口号。一旦 WebTransport.ready promise 兑现,你就可以开始使用连接。

async function initTransport(url) {
  // 初始化传输的连接
  const transport = new WebTransport(url);

  // 连接一旦成功兑现,就可以开始使用
  await transport.ready;
  return transport;
}

你可以通过等待 WebTransport.closed promise 的兑现来响应连接关闭。WebTransport 操作返回的错误是 WebTransportError 类型的,除了标准的 DOMException 集合之外,还包含其他数据。

以下的 closeTransport() 方法展示了一种可能的实现方式。在 try...catch 块中,它使用 await 等待 closed promise 的兑现或拒绝,然后报告连接是因为意外关闭还是因为错误关闭。

async function closeTransport(transport) {
  // 响应连接的关闭
  try {
    await transport.closed;
    console.log(`到 ${url} 的 HTTP/3 连接已正常关闭。`);
  } catch (error) {
    console.error(`到 ${url} 的 HTTP/3 连接由于 ${error} 而被关闭。`);
  }
}

我们可以在自己的异步函数中调用上面的异步函数,如下所示。

// 使用传输
async function useTransport(url) {
  const transport = await initTransport(url);

  // 使用传输对象来发送和接收数据
  // ……

  // 在完成时关闭传输
  await closeTransport(transport);
}

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

参见单独的属性和方法页面以获取其他示例代码。

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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