WebTransport: thuộc tính datagrams

Baseline 2026

Newly available

Since March 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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.

Thuộc tính chỉ đọc datagrams của giao diện WebTransport trả về một thể hiện WebTransportDatagramDuplexStream có thể dùng để gửi và nhận datagram, tức truyền dữ liệu không đáng tin cậy.

"Không đáng tin cậy" có nghĩa là việc truyền dữ liệu không được bảo đảm, và dữ liệu cũng không được bảo đảm sẽ đến theo một thứ tự cụ thể. Điều này phù hợp trong một số tình huống và cung cấp tốc độ phân phối rất nhanh. Ví dụ, bạn có thể muốn truyền các bản cập nhật trạng thái trò chơi thường xuyên, trong đó mỗi thông điệp mới thay thế thông điệp đến trước đó, và thứ tự không quan trọng.

const writer = transport.datagrams.writable.getWriter();
const data1 = new Uint8Array([65, 66, 67]);
const data2 = new Uint8Array([68, 69, 70]);
writer.write(data1);
writer.write(data2);

Đọc một datagram đến

Thuộc tính WebTransportDatagramDuplexStream.readable trả về một đối tượng ReadableStream mà bạn có thể dùng để nhận dữ liệu từ máy chủ:

async function readData() {
  const reader = transport.datagrams.readable.getReader();
  while (true) {
    const { value, done } = await reader.read();
    if (done) {
      break;
    }
    // value là một Uint8Array.
    console.log(value);
  }
}