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

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.

Fontes