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.