CKTIS / JavaScript
ReadableStream — čitanje podataka u dijelovima
ReadableStream omogućuje obradu podataka u dijelovima. Čitač ih dohvaća asinkrono, bez potrebe da se najprije prikupi cijeli ulaz.
Verzija: 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 dio je standarda Streams, a ne ECMAScripta. Zadani tokovi prenose proizvoljne JavaScript vrijednosti; type: "bytes" omogućuje BYOB čitanja u međuspremnike koje osigurava potrošač.
Izvori upotrebljavaju enqueue() za dodavanje dijelova. close() omogućuje pražnjenje reda čekanja; pogreške uzrokuju odbijanje čitanja. read() vraća promise za { value, done }.
getReader() zaključava tok za jednog čitača. releaseLock() otključava tok bez otkazivanja izvora. Ako je čitač aktivan, otkaži putem reader.cancel(); otkazivanje odbacuje red čekanja.
pull() podržava proizvodnju prema potražnji; bezuvjetni pozivi enqueue() mogu povećati red čekanja unatoč povratnom pritisku. Provjeri podršku u ciljnom okruženju; Node 24 ne dokazuje podršku u preglednicima.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.