База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

ReadableStream.pipeTo — прехвърляне към поток за запис

pipeTo() прехвърля блокове към WritableStream, спазва обратното налягане и връща обещание, което указва завършването на операцията.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

ReadableStream.pipeTo прехвърля блокове към WritableStream. Връща Promise, което при успех се изпълнява със стойност undefined. За разлика от него pipeThrough() връща съществуващия поток за четене от подадената двойка, без да създава нов.

Прехвърлянето спазва обратното налягане: четенето зависи от готовността на целта. Методът заключва и двата потока и освобождава заключванията след приключване. Ако някой от потоците вече е заключен, promise се отхвърля с грешка TypeError.

По подразбиране затварянето на източника затваря целта, грешка в източника прекъсва целта, а грешка в целта отменя източника. preventClose, preventAbort и preventCancel съответно изключват това предаване; стойността по подразбиране и на трите е false. Те не предотвратяват отхвърлянето на promise. signal приема AbortSignal; прекъсването отменя източника и прекъсва целта, като се съобразява с тези опции.

Обработвайте отхвърлянето с await и try/catch или с .catch(). Това е Web API от стандарта WHATWG Streams, а не функция на конкретно издание на ECMAScript. Проверете наличността в целевия браузър; Node 24 не доказва поддръжка от браузърите.

Примери

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

Резултат

A|B|closed
false false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници