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 argumentsblob.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