Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes