CKTIS / JavaScript
ReadableStream.getReader(): čítače a uzamknutie streamu
getReader() vracia čítač a uzamkne stream. Čítanie je asynchrónne; releaseLock() zámok uvoľní, ale stream nezruší.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
stream.getReader()
stream.getReader({ mode: "byob" })stream.getReader() synchrónne vracia ReadableStreamDefaultReader. Zámok bráni získaniu ďalšieho čítača; pokus o to vyvolá TypeError.
reader.read() vracia promise s výsledkom { value, done }. done: true znamená koniec; odmietnutie promise signalizuje chybu. Zámok uvoľnite pomocou reader.releaseLock() v bloku finally. Uvoľnenie stream nezruší.
stream.getReader({ mode: "byob" }) vracia ReadableStreamBYOBReader: read(view) prijíma pohľad na buffer. Režim BYOB vyžaduje čitateľný bajtový stream bez ohľadu na to, ako vznikol. Volanie getReader() v tomto režime na streame, ktorý nie je bajtový, vyvolá TypeError. Voľba type: "bytes" je jedným zo spôsobov, ako takýto stream vytvoriť. Telo odpovede Fetch, ak nie je null, môže byť už samo čitateľným bajtovým streamom bez toho, aby ho volajúci kód musel vytvárať. Samotné zaraďovanie blokov Uint8Array do frontu nestačí.
Ide o webové API WHATWG, nie o funkciu konkrétnej edície ECMAScriptu. V cieľovom prostredí overte dostupnosť predvoleného čítača a BYOB osobitne.
Príklady
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);Výsledok
AB false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.