Перейти к содержимому

WHATWG Streams

Читаемые, записываемые, преобразующие, байтовые и BYOB-потоки.

На этой странице

Elide предоставляет читаемые, записываемые и преобразующие потоки с читателями, писателями, контроллерами, стратегиями очередей, конвейерами, разветвлением и асинхронной итерацией.

ReadableStream

const stream = new ReadableStream({
  start(controller) {
    controller.enqueue("hello");
    controller.enqueue("world");
    controller.close();
  },
});

const reader = stream.getReader();
(await reader.read()).value; // "hello"
(await reader.read()).value; // "world"
(await reader.read()).done;  // true

Читаемые потоки предоставляют cancel(), getReader(), pipeThrough(), pipeTo(), tee(), асинхронную итерацию, values() и ReadableStream.from().

WritableStream и TransformStream

Записываемые потоки предоставляют abort(), close() и getWriter(). Преобразующие потоки связывают записываемый вход с читаемым выходом.

const upper = new TransformStream({
  transform(chunk, controller) {
    controller.enqueue(chunk.toUpperCase());
  },
});

const source = ReadableStream.from(["hello"]);
const destination = new WritableStream({
  write(chunk) {
    console.log(chunk); // HELLO
  },
});

await source.pipeThrough(upper).pipeTo(destination);

Противодавление использует настроенный highWaterMark и алгоритм size. CountQueuingStrategy и ByteLengthQueuingStrategy — глобальные объекты.

Байтовые и BYOB-потоки

const bytes = new ReadableStream({
  type: "bytes",
  start(controller) {
    controller.enqueue(new Uint8Array([1, 2, 3]));
    controller.close();
  },
});

const reader = bytes.getReader({ mode: "byob" });
const target = new Uint8Array(8);
const pending = reader.read(target);
target.buffer.byteLength; // 0: transferred immediately

const { value } = await pending;
Array.from(value); // [1, 2, 3]

Операции BYOB передают и отсоединяют переданный буфер. Повторное использование исходного представления приводит к исключению. Передаваемые потоки поддерживаются в пределах одного realm; передача между воркерами остаётся ограниченной.

Байтовые преобразования описаны в разделе Потоки сжатия.

Reference

Status: Full · Not measured · since 1.1.0

Exports

ExportKindStatusNotes
ReadableStreamclassFulllocked, cancel(), getReader(), pipeThrough(), pipeTo(), tee()
ReadableStreamDefaultReaderclassFullclosed, read(), releaseLock(), cancel()
ReadableStreamDefaultControllerclassFulldesiredSize, close(), enqueue(), error()
ReadableStreamBYOBReaderclassFullclosed, read(), releaseLock(), cancel()
ReadableByteStreamControllerclassFullbyobRequest, desiredSize, close(), enqueue(), error()
ReadableStreamBYOBRequestclassFullview, respond(), respondWithNewView()
WritableStreamclassFulllocked, abort(), close(), getWriter()
WritableStreamDefaultWriterclassFullclosed, desiredSize, ready, abort(), close(), releaseLock(), write()
WritableStreamDefaultControllerclassFullsignal, error()
TransformStreamclassFullreadable, writable
TransformStreamDefaultControllerclassFulldesiredSize, enqueue(), error(), terminate()
CountQueuingStrategyclassFullhighWaterMark, size
ByteLengthQueuingStrategyclassFullhighWaterMark, size

Была ли эта страница полезной?