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

CKTIS / JavaScript

ReadableStream.pipeTo — encaminhar para um fluxo gravável

pipeTo() transfere blocos para um WritableStream, respeita a contrapressão e devolve uma promessa que indica a conclusão da operação.

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

readable.pipeTo(destination, { preventClose: false, preventAbort: false, preventCancel: false, signal })

ReadableStream.pipeTo transfere blocos para um WritableStream. Devolve uma Promise que, em caso de sucesso, é cumprida com undefined. Já pipeThrough() devolve o fluxo de leitura que já faz parte do par fornecido, sem criar um novo.

O encaminhamento respeita a contrapressão: a leitura depende de o destino estar pronto. Bloqueia ambos os fluxos e liberta os bloqueios quando termina. Se algum dos fluxos já estiver bloqueado, a promessa é rejeitada com um TypeError.

Por predefinição, o fecho da origem fecha o destino, um erro na origem aborta o destino e um erro no destino cancela a origem. preventClose, preventAbort e preventCancel desativam, respetivamente, essa propagação; todas têm o valor predefinido false. Não impedem a rejeição da promessa. signal aceita um AbortSignal; ao abortar, cancela-se a origem e aborta-se o destino, sem prejuízo dessas opções.

Trata as rejeições com await e try/catch, ou com .catch(). Esta é uma Web API do padrão WHATWG Streams, não uma funcionalidade de uma edição específica de ECMAScript. Verifica a disponibilidade no navegador de destino; o Node 24 não comprova o suporte nos navegadores.

Exemplos

(async () => {
  const chunks = [];
  const readable = new ReadableStream({
    start(controller) {
      controller.enqueue("A");
      controller.enqueue("B");
      controller.close();
    }
  });
  const writable = new WritableStream({
    write(chunk) {
      chunks.push(chunk);
    },
    close() {
      chunks.push("closed");
    }
  });

  await readable.pipeTo(writable);
  console.log(chunks.join("|"));
  console.log(readable.locked, writable.locked);
})().catch(console.error);

Resultado

A|B|closed
false false

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