CKTIS / JavaScript
ReadableStream.pipeThrough() : transformer un flux
pipeThrough() achemine les données du flux vers le côté writable d’une paire fournie et renvoie immédiatement son côté readable. Cela permet d’enchaîner des transformations avec propagation de la contre-pression ; la méthode ne renvoie pas de promesse d’achèvement.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
source.pipeThrough({ writable, readable }, { preventClose, preventAbort, preventCancel, signal })ReadableStream.pipeThrough() est une méthode d’instance définie par WHATWG Streams, et non par ECMAScript. Elle accepte un TransformStream ou une paire { writable, readable } : elle connecte la source à writable et renvoie exactement readable, pas une Promise. Pour une paire quelconque, la méthode ne connecte pas elle-même les deux côtés.
Le pipage verrouille la source et le writable de destination pendant l’opération ; si l’un des deux est déjà verrouillé, un TypeError est levé de manière synchrone. Une chaîne utilisant TransformStream propage la contre-pression. Consommez le résultat : sans consommateur, la transformation peut se bloquer. En revanche, pipeTo() renvoie une promesse d’achèvement du pipage.
Les options s’appliquent à la connexion source → writable. Par défaut, la fermeture de la source ferme la destination, une erreur de la source interrompt la destination et une erreur de la destination annule la source. Respectivement, preventClose, preventAbort et preventCancel désactivent ces comportements ; leur valeur par défaut est false. signal permet d’interrompre l’opération, sous réserve de ces options. Surveillez les erreurs lors de la consommation du résultat ; pipeThrough() n’expose pas sa promesse de pipage interne.
L’exemple double deux blocs et attend le pipeTo() final. Vérifiez la disponibilité des API dans le navigateur cible ; la présence de Node 24 dans un dépôt ne prouve pas leur prise en charge par les navigateurs.
Exemples
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);Résultat
[4,8]
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.