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.