Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

WritableStream — flusso scrivibile

WritableStream serializza la scrittura di blocchi di dati verso una destinazione. Le promesse consentono ai produttori di controllare il proprio ritmo.

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 WritableStream({ start(controller) {}, write(chunk, controller) {}, close() {}, abort(reason) {} }, strategy)

WritableStream è una Web API definita dallo Streams Standard, non da ECMAScript. Verifica la disponibilità nell’ambiente di destinazione; Node 24 non dimostra il supporto nei browser.

Callback facoltative della destinazione: start(controller) inizializza; write(chunk, controller) scrive in sequenza dopo l’inizializzazione; close() termina dopo le scritture; abort(reason) esegue la pulizia in caso di interruzione. L’interruzione scarta le scritture in attesa invece di completarle.

getWriter() blocca il flusso. A quel punto usa writer.write(), writer.close() e writer.abort(); stream.close() e stream.abort() vengono rifiutate mentre il flusso è bloccato. releaseLock() sblocca il flusso senza chiuderlo.

Attendere write() regola il ritmo di produzione; writer.ready segnala che la contropressione si è ridotta. La sola accodatura non limita l’uso della memoria. Una scrittura riuscita non garantisce la memorizzazione permanente dei dati.

Esempi

async function main() {
  const events = [];
  const stream = new WritableStream({
    start() { events.push('start'); },
    write(chunk) { events.push(`write:${chunk}`); },
    close() { events.push('close'); },
    abort(reason) { events.push(`abort:${reason}`); }
  });
  const writer = stream.getWriter();
  try {
    await writer.write('A');
    await writer.write('B');
    await writer.close();
  } finally {
    writer.releaseLock();
  }
  console.log(events.join(' | '));
}
main().catch(console.error);

Risultato

start | write:A | write:B | close

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