CKTIS / JavaScript
ReadableStream.getReader(): bralniki in zaklep toka
getReader() vrne bralnik in zaklene tok. Branje je asinhrono; releaseLock() sprosti zaklep, ne da bi preklical tok.
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
stream.getReader()
stream.getReader({ mode: "byob" })stream.getReader() sinhrono vrne ReadableStreamDefaultReader. Zaklep preprečuje pridobitev drugega bralnika; poskus sproži TypeError.
reader.read() vrne obljubo z rezultatom { value, done }. done: true pomeni, da je branje končano; zavrnitev obljube nakazuje napako. Zaklep sprosti z reader.releaseLock() v bloku finally. Sprostitev toka ne prekliče.
stream.getReader({ mode: "byob" }) vrne ReadableStreamBYOBReader: read(view) sprejme pogled medpomnilnika. Način BYOB zahteva berljiv bajtni tok, ne glede na to, kako je bil ustvarjen. Klic getReader() v tem načinu na toku, ki ni bajtni, sproži TypeError. Možnost type: "bytes" je eden od načinov za ustvarjanje takega toka. Telo odgovora Fetch, če ni null, je lahko že berljiv bajtni tok, ne da bi ga morala ustvariti klicna koda. Zgolj dodajanje kosov Uint8Array v čakalno vrsto ne zadostuje.
To je spletni API WHATWG, ne funkcija določene izdaje ECMAScript. V ciljnem okolju ločeno preveri razpoložljivost privzetega bralnika in BYOB.
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);
console.log(stream.locked);
}
main().catch(console.error);Rezultat
AB false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.