CKTIS / JavaScript
Blob.stream() e Blob.size: ler ou contar bytes
Usa `blob.size` para saber o número total de bytes sem ler o conteúdo e `blob.stream()` para processar esses bytes por blocos.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
blob.size // number of bytes; read-only property
blob.stream() // ReadableStream of bytes; no argumentsblob.size é uma propriedade só de leitura que devolve o número total de bytes como Number. Consulta-a sem parênteses. Não indica o número de caracteres nem quantos bytes já foram lidos. O construtor Blob codifica as cadeias de texto em UTF-8, pelo que o comprimento de uma cadeia em JavaScript pode ser diferente do tamanho do blob.
blob.stream() é um método de instância sem argumentos. Devolve um novo ReadableStream de bytes não descodificados. Usa size quando só precisas do total e stream() quando queres processar os dados por blocos sem acumular todo o conteúdo num único buffer. Não partas do princípio de que os blocos têm um tamanho fixo. Para voltares a ler desde o início, chama blob.stream() novamente.
getReader() bloqueia o fluxo para uso exclusivo desse leitor. Aguarda o resultado de read() com await e verifica done antes de usares value: done: true indica que não há mais blocos. Como a promessa da leitura pode ser rejeitada, liberta o bloqueio com releaseLock() em finally. Isto não faz o fluxo voltar ao início nem o cancela.
Blob e ReadableStream são API da plataforma Web, não funcionalidades da linguagem garantidas pelo ECMAScript 2024. Verifica se estão disponíveis no ambiente de execução de destino.
Exemplos
(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));Resultado
size=3; bytesRead=3
Em UTF-8, `A` ocupa um byte e `é` ocupa dois. Após a leitura completa, a soma de `value.byteLength` é 3 e coincide com `blob.size`, independentemente da divisão em blocos.
Lições relacionadas
- JavaScript · Lição 4 · Avançado · Versão: 4