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.