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

CKTIS / JavaScript

ReadableStream — leer datos en fragmentos

ReadableStream permite consumir datos en fragmentos. Un lector los obtiene de forma asíncrona sin tener que recopilar primero toda la entrada.

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

new ReadableStream(underlyingSource?, strategy?)

ReadableStream pertenece al Streams Standard, no a ECMAScript. Los streams predeterminados transportan valores JavaScript arbitrarios; type: "bytes" permite lecturas BYOB en búferes proporcionados por quien consume el stream.

Las fuentes usan enqueue() para añadir fragmentos. close() permite que se vacíe la cola; los errores hacen que se rechacen las lecturas. read() devuelve una promesa para { value, done }.

getReader() bloquea el stream para un solo lector. releaseLock() lo desbloquea sin cancelar la fuente. Si hay un lector activo, cancela mediante reader.cancel(); la cancelación descarta la cola.

pull() permite producir según la demanda; usar enqueue() sin condiciones puede hacer crecer la cola a pesar de la contrapresión. Comprueba la compatibilidad del entorno de destino; Node 24 no demuestra que haya compatibilidad en navegadores.

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

main().catch(console.error);

Resultado

AB

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