ReadableByteStreamController: свойство byobRequest

Свойство byobRequest только для чтения интерфейса ReadableByteStreamController возвращает текущий запрос BYOB или null, если запросов нет.

Подлежащий байтовый источник должен проверять это свойство и использовать его для записи данных в поток, если оно существует (а не использовать ReadableByteStreamController.enqueue()). Это приведет к эффективному обмену данными нулевого размера потребителю.

Объект экземпляра ReadableStreamBYOBRequest или null.

Пример в Использование потоков байтов для чтения > Создание потока байтов для чтения из сокета демонстрирует, как использовать byobRequest для передачи данных (если они существуют), в противном случае копируя данные во внутренние очереди потока с помощью ReadableByteStreamController.enqueue().

Релевантный код приведён ниже. Если byobRequest существует, данные считываются в controller.byobRequest.view, а затем вызывается ReadableStreamBYOBRequest.respond() для сигнализации о количестве данных, готовых к передаче.

if (controller.byobRequest) {
  const v = controller.byobRequest.view;
  bytesRead = socket.readInto(v.buffer, v.byteOffset, v.byteLength);
  if (bytesRead === 0) {
    controller.close();
  }
  controller.byobRequest.respond(bytesRead);
} else {
  // Write to data using enqueue().
}

• Использование потоков байтов для чтения
• ReadableByteStreamController