CKTIS / JavaScript
ReadableStream.pipeTo — transférer vers un flux inscriptible
pipeTo() transfère des blocs vers un WritableStream, respecte la contre-pression et renvoie une promesse qui indique la fin de l’opération.
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
readable.pipeTo(destination, { preventClose: false, preventAbort: false, preventCancel: false, signal })ReadableStream.pipeTo transfère des blocs vers un WritableStream. La méthode renvoie une Promise qui est résolue avec undefined en cas de réussite. En revanche, pipeThrough() renvoie le flux lisible déjà présent dans la paire fournie, sans créer de nouveau flux.
Le transfert respecte la contre-pression : la lecture dépend de la disponibilité de la destination. Les deux flux sont verrouillés et leurs verrous sont libérés à la fin. Si l’un des flux est déjà verrouillé, la promesse est rejetée avec une TypeError.
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. preventClose, preventAbort et preventCancel désactivent respectivement cette propagation ; leur valeur par défaut est false. Elles n’empêchent pas le rejet de la promesse. signal accepte un AbortSignal ; une interruption annule la source et interrompt la destination, sous réserve de ces options.
Gérez les rejets avec await et try/catch, ou avec .catch(). Il s’agit d’une API Web du standard WHATWG Streams, et non d’une fonctionnalité propre à une édition particulière d’ECMAScript. Vérifiez sa disponibilité dans le navigateur cible ; Node 24 ne permet pas d’établir la prise en charge par les navigateurs.
Exemples
(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);Résultat
A|B|closed false false
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.