Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

ReadableStream — leggere i dati a blocchi

ReadableStream permette di consumare i dati a blocchi. Un reader li recupera in modo asincrono senza dover prima raccogliere l’intero input.

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

new ReadableStream(underlyingSource?, strategy?)

ReadableStream fa parte dello Streams Standard, non di ECMAScript. Gli stream predefiniti trasportano valori JavaScript arbitrari; type: "bytes" abilita le letture BYOB in buffer forniti dal consumatore.

Le sorgenti usano enqueue() per aggiungere blocchi. close() consente alla coda di svuotarsi; gli errori fanno rifiutare le letture. read() restituisce una promise per { value, done }.

getReader() blocca lo stream per un solo reader. releaseLock() sblocca lo stream senza annullare la sorgente. Con un reader attivo, annulla tramite reader.cancel(); l’annullamento elimina la coda.

pull() supporta la produzione su richiesta; chiamate incondizionate a enqueue() possono far crescere la coda nonostante la contropressione. Verifica il supporto nell’ambiente di destinazione; Node 24 non dimostra il supporto nei browser.

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);
}

main().catch(console.error);

Risultato

AB

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