Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Blob: dimensione in byte e lettura in streaming

Blob memorizza dati binari immutabili. La proprietà Blob.size ne indica la dimensione in byte, mentre Blob.stream() rende i dati disponibili per la lettura asincrona, un blocco alla volta, tramite un ReadableStream.

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 Blob(blobParts, options)
blob.size
blob.stream()

Blob è un oggetto che contiene dati grezzi e immutabili. Il costruttore new Blob(blobParts, options) combina le parti fornite in un unico oggetto. File eredita le funzionalità di Blob, ma aggiunge informazioni relative ai file.

Blob.size indica la proprietà di istanza consultata come blob.size, senza parentesi. È di sola lettura e restituisce il numero di byte dei dati, non il numero di caratteri del testo. Per ottenere la dimensione non è necessario leggere i contenuti in modo asincrono.

Blob.stream indica il metodo di istanza chiamato come blob.stream(), senza argomenti. Restituisce un ReadableStream, non una promise contenente tutti i dati. Un lettore ottenuto tramite getReader() consente di recuperare blocchi di byte in modo asincrono. Nell’esempio si sommano i rispettivi byteLength finché done non è true; non si presuppone un numero o una dimensione specifici dei blocchi. Lo streaming non modifica i dati del Blob.

Queste sono interfacce Web API, non funzionalità assegnate a un’edizione di ECMAScript. MDN indica un’ampia disponibilità di Blob.size da luglio 2015 e di Blob.stream() da aprile 2021. Entrambi sono disponibili anche nei Web Workers. Verifica separatamente il supporto nei browser di destinazione; la presenza di Node 24 in un repository non dimostra tale supporto.

Esempi

async function main() {
  const blob = new Blob([new Uint8Array([65, 66, 67])]);
  const reader = blob.stream().getReader();
  let total = 0;

  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) break;
      total += value.byteLength;
    }
  } finally {
    reader.releaseLock();
  }

  console.log(`size=${blob.size}`);
  console.log(`read=${total}`);
  console.log(`match=${total === blob.size}`);
}

main().catch(console.error);

Risultato

size=3
read=3
match=true

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