WebTransportDatagramDuplexStream

Интерфейс WebTransportDatagramDuplexStream API WebTransport представляет собой дуплексный поток, который можно использовать для ненадежной передачи датаграмм между клиентом и сервером. Предоставляет доступ к ReadableStream для чтения входящих датаграмм, к WritableStream для записи исходящих датаграмм и различным настройкам и статистике, связанным с потоком.

К нему можно получить доступ через свойство WebTransport.datagrams.

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

incomingHighWaterMark

Получает или задаёт высокую отметку для входящих кусков данных — это максимальный размер, в кусках, который может достичь внутренняя очередь входящего ReadableStream, прежде чем он будет считаться полным. Дополнительную информацию см. в разделе Внутренние очереди и стратегии очередирования.

incomingMaxAge

Получает или задаёт максимальный срок жизни для входящих датаграмм в миллисекундах. Возвращает null , если максимальный срок жизни не задан.

maxDatagramSize Только для чтения

Возвращает максимально допустимый размер исходящих датаграмм в байтах, которые могут быть записаны в writable.

outgoingHighWaterMark

Получает или задаёт высокую отметку для исходящих кусков данных — это максимальный размер, в кусках, который может достичь внутренняя очередь исходящего WritableStream, прежде чем он будет считаться полным. Дополнительную информацию см. в разделе Внутренние очереди и стратегии очередирования.

outgoingMaxAge

Получает или задаёт максимальный срок жизни для исходящих датаграмм в миллисекундах. Возвращает null , если максимальный срок жизни не задан.

readable Только для чтения

Возвращает экземпляр ReadableStream, который можно использовать для чтения входящих датаграмм из потока.

writable Только для чтения

Возвращает экземпляр WritableStream, который можно использовать для записи исходящих датаграмм в поток.

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

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

Свойство 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