CKTIS / JavaScript
ReadableStream.getReader(): čitači i zaključavanje toka
getReader() vraća čitač i zaključava tok. Čitanje je asinkrono; releaseLock() oslobađa zaključavanje, ali ne otkazuje tok.
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
stream.getReader()
stream.getReader({ mode: "byob" })stream.getReader() sinkrono vraća ReadableStreamDefaultReader. Zaključavanje onemogućuje dobivanje drugog čitača; pokušaj izaziva TypeError.
reader.read() vraća obećanje s rezultatom { value, done }. done: true znači da je čitanje dovršeno; odbijanje obećanja signalizira pogrešku. Oslobodi zaključavanje pomoću reader.releaseLock() u bloku finally. Oslobađanje ne otkazuje tok.
stream.getReader({ mode: "byob" }) vraća ReadableStreamBYOBReader: read(view) prihvaća prikaz međuspremnika. Način rada BYOB zahtijeva čitljiv tok bajtova, bez obzira na to kako je stvoren. Poziv metode getReader() u tom načinu rada na toku koji nije tok bajtova izaziva TypeError. Opcija type: "bytes" jedan je od načina stvaranja takvog toka. Tijelo odgovora dobivenog putem API-ja Fetch, ako nije null, može već biti čitljiv tok bajtova, pa ga pozivajući kôd ne mora sam stvoriti. Samo stavljanje blokova Uint8Array u red nije dovoljno.
Ovo je WHATWG-ov web API, a ne značajka određene edicije ECMAScripta. U ciljnom okruženju zasebno provjeri dostupnost zadanog čitača i BYOB-a.
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);
console.log(stream.locked);
}
main().catch(console.error);Rezultat
AB false
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.