CKTIS / JavaScript
Blob: tamanho em bytes e leitura em fluxo
Blob armazena dados binários imutáveis. A propriedade Blob.size indica o seu tamanho em bytes, enquanto Blob.stream() disponibiliza os dados para leitura assíncrona, bloco a bloco, através de um ReadableStream.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
new Blob(blobParts, options)
blob.size
blob.stream()Blob é um objeto que contém dados em bruto e imutáveis. O construtor new Blob(blobParts, options) combina as partes fornecidas num único objeto. File herda a funcionalidade de Blob, mas acrescenta informações relacionadas com ficheiros.
Blob.size designa a propriedade de instância acedida como blob.size, sem parênteses. É só de leitura e devolve o número de bytes dos dados, não o número de caracteres do texto. Para obter o tamanho, não é necessário ler os conteúdos de forma assíncrona.
Blob.stream designa o método de instância chamado como blob.stream(), sem argumentos. Devolve um ReadableStream, não uma promessa com todo o conteúdo. Um leitor obtido através de getReader() permite obter blocos de bytes de forma assíncrona. No exemplo, somam-se os respetivos valores byteLength até que done seja true; não se pressupõe um número ou tamanho específico para os blocos. A leitura em fluxo não altera os dados do Blob.
Estas são interfaces Web API, não funcionalidades atribuídas a uma edição de ECMAScript. A MDN indica disponibilidade alargada de Blob.size desde julho de 2015 e de Blob.stream() desde abril de 2021. Ambos também estão disponíveis em Web Workers. Verifique separadamente o suporte nos navegadores de destino; a presença de Node 24 num repositório não comprova esse suporte.
Exemplos
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);Resultado
size=3 read=3 match=true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.