WebTransport: свойство datagrams

Толковаемое только для чтения свойство datagrams интерфейса WebTransport возвращает экземпляр WebTransportDatagramDuplexStream, который можно использовать для отправки и получения датаграмм — ненадежной передачи данных.

«Ненадёжная» означает, что передача данных не гарантирована, ни порядок прибытия. Это подходит в некоторых ситуациях и обеспечивает очень быструю доставку. Например, вы можете передавать регулярные обновления состояния игры, где каждое сообщение заменяет предыдущее прибывшее, а порядок не имеет значения.

Объект WebTransportDatagramDuplexStream.

Свойство WebTransportDatagramDuplexStream.writable возвращает объект WritableStream, в который можно записать данные с помощью writer для передачи на сервер:

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);

Свойство WebTransportDatagramDuplexStream.readable возвращает объект ReadableStream, который можно использовать для получения данных от сервера:

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

• Использование WebTransport
• API WebSockets
• API потоков
• WebTransport поверх HTTP/3