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

CKTIS / JavaScript

WritableStream — поток за запис

WritableStream подрежда последователно записването на части от данни към целеви обект. Promises позволяват на производителите да контролират темпото си.

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

Синтаксис

new WritableStream({ start(controller) {}, write(chunk, controller) {}, close() {}, abort(reason) {} }, strategy)

WritableStream е уеб API, дефиниран от Streams Standard, а не от ECMAScript. Проверете наличността в целевата среда; Node 24 не доказва поддръжка в браузърите.

Незадължителни callbacks на целевия обект: start(controller) инициализира; write(chunk, controller) записва последователно след инициализацията; close() завършва след записите; abort(reason) извършва почистване при прекъсване. Прекъсването отхвърля чакащите записи, вместо да ги завърши.

getWriter() заключва потока. След това използвайте writer.write(), writer.close() и writer.abort(); stream.close() и stream.abort() се отхвърлят, докато потокът е заключен. releaseLock() отключва потока, без да го затваря.

Изчакването на write() регулира темпото на производство; writer.ready сигнализира, че обратното налягане е намаляло. Самото поставяне в опашка не ограничава използването на памет. Успешният запис не гарантира трайно съхранение на данните.

Примери

async function main() {
  const events = [];
  const stream = new WritableStream({
    start() { events.push('start'); },
    write(chunk) { events.push(`write:${chunk}`); },
    close() { events.push('close'); },
    abort(reason) { events.push(`abort:${reason}`); }
  });
  const writer = stream.getWriter();
  try {
    await writer.write('A');
    await writer.write('B');
    await writer.close();
  } finally {
    writer.releaseLock();
  }
  console.log(events.join(' | '));
}
main().catch(console.error);

Резултат

start | write:A | write:B | close

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

Източници