CKTIS / JavaScript
ReadableStream — čítanie údajov po častiach
ReadableStream umožňuje spracúvať údaje po častiach. Čítačka ich získava asynchrónne bez toho, aby bolo potrebné najprv zhromaždiť celý vstup.
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
new ReadableStream(underlyingSource?, strategy?)ReadableStream patrí do Streams Standard, nie do ECMAScriptu. Predvolené streamy prenášajú ľubovoľné hodnoty JavaScriptu; type: "bytes" umožňuje čítanie BYOB do bufferov dodaných príjemcom.
Zdroje používajú enqueue() na pridávanie častí. close() umožní vyprázdnenie frontu; chyby spôsobia zamietnutie čítaní. read() vráti promise s výsledkom { value, done }.
getReader() uzamkne stream pre jednu čítačku. releaseLock() zámok uvoľní bez zrušenia zdroja. Ak je čítačka aktívna, zrušenie vykonajte pomocou reader.cancel(); zrušenie zahodí front.
pull() podporuje produkciu podľa požiadaviek; bezpodmienečné volanie enqueue() môže zväčšovať front aj napriek spätnému tlaku. Overte podporu v cieľovom prostredí; Node 24 nedokladá podporu v prehliadačoch.
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);
}
main().catch(console.error);Výsledok
AB
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.