CKTIS / JavaScript
ReadableStream.pipeThrough(): trasformare uno stream
pipeThrough() instrada i dati dello stream verso il lato writable di una coppia fornita e restituisce subito il suo lato readable. Consente di concatenare trasformazioni propagando la contropressione; non restituisce una promise di completamento.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
source.pipeThrough({ writable, readable }, { preventClose, preventAbort, preventCancel, signal })ReadableStream.pipeThrough() è un metodo di istanza definito da WHATWG Streams, non da ECMAScript. Accetta un TransformStream o una coppia { writable, readable }: collega la sorgente a writable e restituisce esattamente readable, non una Promise. Con una coppia qualsiasi, il metodo non collega autonomamente i due lati.
Il piping blocca la sorgente e il writable di destinazione per la durata dell’operazione; se uno dei due è già bloccato, viene generato sincronicamente un TypeError. Una catena che usa TransformStream propaga la contropressione. Consuma il risultato: senza un consumatore, la trasformazione può bloccarsi. Al contrario, pipeTo() restituisce una promise che segnala il completamento del piping.
Le opzioni si applicano alla connessione sorgente → writable. Per impostazione predefinita, la chiusura della sorgente chiude la destinazione, un errore della sorgente interrompe la destinazione e un errore della destinazione annulla la sorgente. preventClose, preventAbort e preventCancel disattivano rispettivamente questi comportamenti; il valore predefinito di ciascuna è false. signal consente di interrompere l’operazione, nel rispetto di queste opzioni. Controlla gli errori mentre consumi il risultato; pipeThrough() non espone la propria promise interna di piping.
L’esempio raddoppia due blocchi e attende il pipeTo() finale. Verifica la disponibilità delle API nel browser di destinazione; la presenza di Node 24 in un repository non dimostra il supporto nei browser.
Esempi
async function main() {
const source = new ReadableStream({
start(controller) {
controller.enqueue(2);
controller.enqueue(4);
controller.close();
}
});
const doubled = source.pipeThrough(new TransformStream({
transform(chunk, controller) {
controller.enqueue(chunk * 2);
}
}));
const values = [];
await doubled.pipeTo(new WritableStream({
write(chunk) {
values.push(chunk);
}
}));
console.log(JSON.stringify(values));
}
main().catch(console.error);Risultato
[4,8]
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.