CKTIS / JavaScript
WritableStream — zapisljiv tok
WritableStream zaporedno razvršča zapisovanje podatkovnih kosov v ponor. Promises producentom omogočajo nadzor nad hitrostjo produkcije.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
new WritableStream({ start(controller) {}, write(chunk, controller) {}, close() {}, abort(reason) {} }, strategy)WritableStream je spletni API, določen s standardom Streams Standard, ne pa z ECMAScriptom. Razpoložljivost preverite v ciljnem okolju; Node 24 ne dokazuje podpore v brskalnikih.
Izbirni povratni klici ponora: start(controller) izvede inicializacijo; write(chunk, controller) po inicializaciji zapisuje zaporedno; close() po zapisih zaključi; abort(reason) ob prekinitvi izvede čiščenje. Prekinitev zavrže čakajoče zapise, namesto da bi jih dokončala.
getWriter() zaklene tok. Nato uporabite writer.write(), writer.close() in writer.abort(); stream.close() in stream.abort() sta zavrnjena, dokler je tok zaklenjen. releaseLock() sprosti zaklep, ne da bi tok zaprl.
Čakanje na write() uravnava hitrost produkcije; writer.ready sporoča, da je povratni pritisk popustil. Samo čakanje v vrsti ne omeji porabe pomnilnika. Uspešen zapis ne zagotavlja trajne hrambe podatkov.
Primeri
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);Rezultat
start | write:A | write:B | close
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.