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

CKTIS / JavaScript

Construtor `Blob`: criar uma sequência imutável de bytes

`new Blob()` combina texto e dados binários numa sequência imutável de bytes. As opções definem o tipo MIME e a forma de tratar as terminações de linha.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

new Blob()
new Blob(blobParts)
new Blob(blobParts, options)

Blob é um construtor global da File API da Web disponibilizado pelo ambiente anfitrião e não é um objeto nativo de ECMAScript 2024. Está disponível nos navegadores e em Web Workers; verifica a disponibilidade noutros ambientes de execução. new Blob() cria um Blob vazio de forma síncrona. Chamar Blob() sem new lança um TypeError. Para passar opções sem dados, usa new Blob([], options).

blobParts é um objeto iterável, como um array de cadeias de texto, objetos Blob ou ArrayBuffer, arrays tipados ou vistas DataView. O construtor junta as partes pela ordem de iteração, sem separadores; um objeto não iterável como {} provoca um TypeError. As cadeias são codificadas em UTF-8 depois de substituir os substitutos UTF-16 isolados por U+FFFD. De uma vista sobre um ArrayBuffer são copiados apenas os bytes do seu intervalo; passar view.buffer em vez da vista copia todo o buffer. Passar um array tipado ou uma vista DataView cujo buffer seja um SharedArrayBuffer provoca um TypeError. Alterações posteriores aos dados de entrada não modificam os bytes do Blob.

A opção type define os metadados MIME (blob.type, "" por omissão). Não converte nem valida o conteúdo; não a uses como única verificação de dados não fiáveis. Por omissão, endings é "transparent" e preserva as terminações de linha. "native" adapta as terminações de linha das cadeias à convenção do sistema anfitrião, pelo que os bytes resultantes podem variar entre plataformas. Nenhuma das opções reescreve os bytes das partes binárias.

blob.size conta bytes, não caracteres. blob.arrayBuffer() lê o conteúdo de forma assíncrona como ArrayBuffer. O construtor não cria um ficheiro em disco nem um URL. Se criares um URL separadamente com URL.createObjectURL(blob), liberta-o com URL.revokeObjectURL() quando já não for necessário.

Exemplos

(async () => {
  const bufferView = new Uint8Array([0, 33, 0]);
  const part = bufferView.subarray(1, 2);
  const blob = new Blob(["\u00E9", part], { type: "text/plain" });
  part[0] = 63;

  const bytes = new Uint8Array(await blob.arrayBuffer());
  console.log(`size=${blob.size}, type=${blob.type}`);
  console.log(`bytes=${bytes.join(",")}`);
})();

Resultado

size=3, type=text/plain
bytes=195,169,33

`é` ocupa dois bytes em UTF-8 e a vista só acrescenta o byte `33`. Alterar esse byte para `63` na vista após a construção não altera os bytes lidos do `Blob`.

Lições relacionadas

  • JavaScript · Lição 4 · Avançado · Versão: 4

Fontes