ReadableByteStreamController: метод enqueue()

Метод enqueue() интерфейса ReadableByteStreamController помещает заданный фрагмент в ассоциированный с ним поток байтов для чтения (фрагмент копируется во внутренние очереди потока).

Этот метод следует использовать только для передачи данных в очередь, когда byobRequest null.

chunk

Фрагмент для добавления в очередь.

None (undefined).

TypeError

Выбрасывается, если объект-источник не является ReadableByteStreamController, или поток не может быть прочитан по какой-либо другой причине, или фрагмент не является объектом, или внутренний буфер массива фрагмента не существует, имеет нулевую длину или отсоединён. Также выбрасывается, если поток был закрыт.

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

Ниже показано, как данные считываются в ArrayBuffer с использованием гипотетического метода socket.readInto() и затем добавляются в очередь (но только если данные были скопированы):

const buffer = new ArrayBuffer(DEFAULT_CHUNK_SIZE);
bytesRead = socket.readInto(buffer, 0, DEFAULT_CHUNK_SIZE);
if (bytesRead === 0) {
  controller.close();
} else {
  controller.enqueue(new Uint8Array(buffer, 0, bytesRead));
}

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