Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti