Saltar al contenido

Streams de WHATWG

Flujos legibles, escribibles, de transformación, de bytes y BYOB.

En esta página

Elide expone flujos legibles, escribibles y de transformación con lectores, escritores, controladores, estrategias de cola, encadenamiento (piping), bifurcación (tee) e iteración asíncrona.

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

Los flujos legibles proporcionan cancel(), getReader(), pipeThrough(), pipeTo(), tee(), iteración asíncrona, values() y ReadableStream.from().

WritableStream y TransformStream

Los flujos escribibles proporcionan abort(), close() y getWriter(). Los flujos de transformación emparejan una entrada escribible con una salida legible.

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

La contrapresión usa el highWaterMark y el algoritmo size configurados. CountQueuingStrategy y ByteLengthQueuingStrategy son globales.

Flujos de bytes y 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]

Las operaciones BYOB transfieren y separan el búfer proporcionado. Reutilizar la vista original lanza una excepción. Los flujos transferibles se admiten dentro del mismo realm; la transferencia entre workers sigue siendo limitada.

Consulte Flujos de compresión para las transformaciones de bytes.

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

¿Te resultó útil esta página?