CKTIS / JavaScript
ReadableStream — ler dados em blocos
ReadableStream permite consumir dados em blocos. Um leitor obtém-nos de forma assíncrona, sem ser necessário reunir primeiro toda a entrada.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
new ReadableStream(underlyingSource?, strategy?)ReadableStream faz parte do Streams Standard, não de ECMAScript. Os streams predefinidos transportam valores JavaScript arbitrários; type: "bytes" permite leituras BYOB para buffers fornecidos pelo consumidor.
As fontes usam enqueue() para adicionar blocos. close() permite que a fila seja consumida até ao fim; os erros fazem com que as leituras sejam rejeitadas. read() devolve uma promise para { value, done }.
getReader() bloqueia o stream para um único leitor. releaseLock() desbloqueia-o sem cancelar a fonte. Com um leitor ativo, cancela através de reader.cancel(); o cancelamento descarta a fila.
pull() permite a produção conforme a procura; chamadas incondicionais a enqueue() podem aumentar a fila apesar da contrapressão. Verifica o suporte no ambiente de destino; o Node 24 não comprova o suporte nos browsers.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.