Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

ReadableStream.pipeTo — posredovanje v zapisljivi tok

pipeTo() prenese bloke v WritableStream, upošteva povratni pritisk in vrne obljubo, ki označuje dokončanje operacije.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

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

ReadableStream.pipeTo prenese bloke v WritableStream. Vrne Promise, ki se ob uspehu izpolni z vrednostjo undefined. pipeThrough() pa vrne obstoječi berljivi tok iz podanega para, ne da bi ustvaril novega.

Posredovanje upošteva povratni pritisk: branje je odvisno od pripravljenosti cilja. Zaklene oba toka in po koncu sprosti zaklepa. Če je kateri od tokov že zaklenjen, se obljuba zavrne z napako TypeError.

Privzeto zaprtje vira zapre cilj, napaka vira prekine cilj, napaka cilja pa prekliče vir. Možnosti preventClose, preventAbort in preventCancel po vrsti onemogočijo to širjenje; vse imajo privzeto vrednost false. Ne preprečijo zavrnitve obljube. signal sprejme AbortSignal; prekinitev prekliče vir in prekine cilj, ob upoštevanju teh možnosti.

Zavrnitve obravnavajte z await in try/catch ali z .catch(). To je spletni API standarda WHATWG Streams, ne funkcija določene izdaje ECMAScript. Razpoložljivost preverite v ciljnem brskalniku; Node 24 ne dokazuje podpore v brskalnikih.

Primeri

(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);

Rezultat

A|B|closed
false false

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri