Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

WritableStream — strumień zapisywalny

WritableStream szereguje zapis porcji danych do odbiornika. Obietnice pozwalają kontrolować tempo producenta.

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

Składnia

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

WritableStream to Web API określone w Streams Standard, nie w ECMAScript. Dostępność sprawdź w docelowym środowisku; Node 24 nie dowodzi obsługi w przeglądarce.

Opcjonalne callbacki odbiornika: start(controller) inicjalizuje; write(chunk, controller) zapisuje kolejno po zakończeniu inicjalizacji; close() kończy po zapisach; abort(reason) sprząta przy przerwaniu. Przerwanie odrzuca oczekujące zapisy, zamiast je dokończyć.

getWriter() blokuje strumień. Używaj wtedy writer.write(), writer.close() i writer.abort(); stream.close() oraz stream.abort() odrzucają obietnicę przy blokadzie. releaseLock() zwalnia blokadę, nie zamyka strumienia.

Oczekiwanie na write() ogranicza tempo produkcji; writer.ready sygnalizuje ustąpienie presji zwrotnej. Samo kolejkowanie nie ogranicza pamięci. Sukces zapisu nie gwarantuje trwałego utrwalenia danych.

Przykłady

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

Wynik

start | write:A | write:B | close

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła