CKTIS / JavaScript
ReadableStream.getReader(): lettori e blocco dello stream
getReader() restituisce un lettore e blocca lo stream. La lettura è asincrona; releaseLock() rilascia il blocco senza annullare lo stream.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
stream.getReader()
stream.getReader({ mode: "byob" })stream.getReader() restituisce in modo sincrono un ReadableStreamDefaultReader. Il blocco impedisce di ottenere un altro lettore; tentare di farlo genera un TypeError.
reader.read() restituisce una promise per { value, done }. done: true indica che la lettura è terminata; il rifiuto della promise segnala un errore. Rilascia il blocco con reader.releaseLock() in un blocco finally. Il rilascio non annulla lo stream.
stream.getReader({ mode: "byob" }) restituisce un ReadableStreamBYOBReader: read(view) accetta una vista di buffer. La modalità BYOB richiede uno stream di byte leggibile, indipendentemente da come è stato creato. Chiamare getReader() in questa modalità su uno stream che non è di byte genera un TypeError. L’opzione type: "bytes" è un modo per creare uno stream di questo tipo. Il corpo di una risposta Fetch, se non è null, può essere già uno stream di byte leggibile, senza che il codice chiamante debba crearlo. Accodare soltanto blocchi Uint8Array non è sufficiente.
Questa è una Web API WHATWG, non una funzionalità di una specifica edizione di ECMAScript. Verifica separatamente la disponibilità del lettore predefinito e di BYOB nell’ambiente di destinazione.
Esempi
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);Risultato
AB false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.