Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Blob.stream() e Blob.size: leggere o contare i byte

Usa `blob.size` per conoscere il numero totale di byte senza leggere il contenuto e `blob.stream()` per elaborare quei byte a blocchi.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

blob.size      // number of bytes; read-only property
blob.stream()  // ReadableStream of bytes; no arguments

blob.size è una proprietà di sola lettura: restituisce il numero totale di byte come Number. Si legge senza parentesi. Non conta né i caratteri né i byte già letti. Il costruttore Blob codifica le stringhe in UTF-8, quindi la lunghezza di una stringa JavaScript può differire dalla dimensione del blob.

blob.stream() è un metodo di istanza senza argomenti. Restituisce un nuovo ReadableStream di byte non decodificati. Usa size se ti serve solo il totale e stream() se vuoi elaborare i dati a blocchi, senza accumulare l’intero contenuto in un unico buffer. Non presumere che i blocchi abbiano una dimensione fissa. Per rileggere dall’inizio, chiama di nuovo blob.stream().

getReader() riserva lo stream a quel lettore. Attendi il risultato di read() con await e controlla done prima di usare value: con done: true non ci sono altri blocchi. Poiché la promessa di lettura può essere rifiutata, rilascia il blocco con releaseLock() in finally. Questo non riporta lo stream all’inizio e non lo annulla.

Blob e ReadableStream sono API della piattaforma web, non funzionalità del linguaggio garantite da ECMAScript 2024. Verifica che siano disponibili nell’ambiente di esecuzione di destinazione.

Esempi

(async () => {
  const blob = new Blob(["A\u00E9"]);
  const reader = blob.stream().getReader();
  let bytesRead = 0;

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

  console.log(`size=${blob.size}; bytesRead=${bytesRead}`);
})().catch((error) => console.error(error));

Risultato

size=3; bytesRead=3

In UTF-8, `A` occupa un byte e `é` ne occupa due. Dopo la lettura completa, la somma di `value.byteLength` vale 3 e coincide con `blob.size`, indipendentemente dalla suddivisione in blocchi.

Lezioni correlate

  • JavaScript · Lezione 4 · Avanzato · Versione: 4

Fonti