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

CKTIS / JavaScript

ReadableStream.pipeThrough(): трансформиране на поток

pipeThrough() насочва данните от потока към записваемата страна на подадена двойка и веднага връща нейната четима страна. Позволява свързване на трансформации с предаване на обратното налягане; не връща promise за завършване.

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

Синтаксис

source.pipeThrough({ writable, readable }, { preventClose, preventAbort, preventCancel, signal })

ReadableStream.pipeThrough() е метод на екземпляр, дефиниран от WHATWG Streams, а не от ECMAScript. Приема TransformStream или двойка { writable, readable }: свързва източника с writable и връща точно readable, а не Promise. При произволна двойка методът сам не свързва двете ѝ страни.

По време на прехвърлянето източникът и целевият writable се заключват; ако някой от тях вече е заключен, синхронно възниква TypeError. Верига с TransformStream предава обратното налягане. Консумирай резултата: без потребител трансформацията може да спре. За разлика от това pipeTo() връща promise за завършването на прехвърлянето.

Опциите се отнасят за връзката източник → writable. По подразбиране затварянето на източника затваря целта, грешка в източника прекъсва целта, а грешка в целта отменя източника. Съответно preventClose, preventAbort и preventCancel изключват тези поведения; стойността по подразбиране за всяка е false. signal позволява прекъсване на операцията при спазване на тези опции. Следи за грешки, докато консумираш резултата; pipeThrough() не предоставя вътрешния си promise за прехвърлянето.

Примерът удвоява два блока и изчаква финалния pipeTo(). Провери наличността на API в целевия браузър; наличието на Node 24 в хранилище не доказва поддръжка в браузър.

Примери

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

Резултат

[4,8]

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

Източници