CKTIS / JavaScript
ReadableStream — branje podatkov po kosih
ReadableStream omogoča porabo podatkov po kosih. Bralnik jih pridobiva asinhrono, ne da bi bilo treba najprej zbrati celoten vhod.
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 ReadableStream(underlyingSource?, strategy?)ReadableStream je del standarda Streams, ne ECMAScript. Privzeti tokovi prenašajo poljubne vrednosti JavaScript; type: "bytes" omogoča branje BYOB v medpomnilnike, ki jih zagotovi porabnik.
Viri uporabljajo enqueue() za dodajanje kosov. close() omogoči, da se čakalna vrsta izprazni; napake povzročijo zavrnitev branj. read() vrne promise za { value, done }.
getReader() zaklene tok za enega bralnika. releaseLock() odklene tok, ne da bi preklical vir. Če je bralnik aktiven, prekliči z reader.cancel(); preklic zavrže čakalno vrsto.
pull() podpira ustvarjanje na zahtevo; brezpogojni klici enqueue() lahko povečajo čakalno vrsto kljub povratnemu pritisku. Preveri podporo v ciljnem okolju; Node 24 ne dokazuje podpore v brskalnikih.
Primeri
async function main() {
const stream = new ReadableStream({
start(controller) {
controller.enqueue("A");
controller.enqueue("B");
controller.close();
}
});
const reader = stream.getReader();
let text = "";
try {
while (true) {
const { value, done } = await reader.read();
if (done) break;
text += value;
}
} finally {
reader.releaseLock();
}
console.log(text);
}
main().catch(console.error);Rezultat
AB
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.