Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

ReadableStream.getReader(): lectores y bloqueo del flujo

getReader() devuelve un lector y bloquea el flujo. La lectura es asíncrona; releaseLock() libera el bloqueo sin cancelar el flujo.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

stream.getReader()
stream.getReader({ mode: "byob" })

stream.getReader() devuelve de forma síncrona un ReadableStreamDefaultReader. El bloqueo impide obtener otro lector; intentarlo provoca un TypeError.

reader.read() devuelve una promesa con { value, done }. done: true indica que la lectura ha terminado; el rechazo de la promesa señala un error. Libera el bloqueo con reader.releaseLock() en un bloque finally. Liberarlo no cancela el flujo.

stream.getReader({ mode: "byob" }) devuelve un ReadableStreamBYOBReader: read(view) acepta una vista de búfer. El modo BYOB requiere un flujo de bytes legible, independientemente de cómo se haya creado. Llamar a getReader() en este modo sobre un flujo que no sea de bytes provoca un TypeError. La opción type: "bytes" es una forma de crear este tipo de flujo. El cuerpo de una respuesta de Fetch, si no es null, puede ser ya un flujo de bytes legible, sin que el código que realiza la llamada tenga que crearlo. No basta con poner en cola bloques Uint8Array.

Esta es una API web de WHATWG, no una característica de una edición concreta de ECMAScript. Comprueba por separado la disponibilidad del lector predeterminado y de BYOB en el entorno de destino.

Ejemplos

async function main() {
  const stream = new ReadableStream({
    start(controller) {
      controller.enqueue("A");
      controller.enqueue("B");
      controller.close();
    }
  });
  const reader = stream.getReader();
  let text = "";
  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) break;
      text += value;
    }
  } finally {
    reader.releaseLock();
  }
  console.log(text);
  console.log(stream.locked);
}
main().catch(console.error);

Resultado

AB
false

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes