CKTIS / JavaScript
ReadableStream — čtení dat po částech
ReadableStream umožňuje zpracovávat data po částech. Čtečka je získává asynchronně, aniž by bylo nutné nejprve shromáždit celý vstup.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new ReadableStream(underlyingSource?, strategy?)ReadableStream patří do Streams Standard, nikoli do ECMAScriptu. Výchozí streamy přenášejí libovolné hodnoty JavaScriptu; type: "bytes" umožňuje čtení BYOB do bufferů dodaných příjemcem.
Zdroje používají enqueue() k přidávání částí. close() umožní vyprázdnění fronty; chyby způsobí zamítnutí čtení. read() vrací promise s výsledkem { value, done }.
getReader() uzamkne stream pro jednu čtečku. releaseLock() zámek uvolní, aniž by zrušilo zdroj. Pokud je čtečka aktivní, zrušení proveďte pomocí reader.cancel(); zrušení zahodí frontu.
pull() podporuje produkci podle požadavků; bezpodmínečné volání enqueue() může zvětšovat frontu i přes zpětný tlak. Ověřte podporu v cílovém prostředí; Node 24 nedokládá podporu v prohlížečích.
Pří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ýsledek
AB
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.