Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 arguments

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

Fontes