Blob()

O construtor Blob() devolve um novo objeto Blob. O conteúdo do objeto Blob consiste na concatenação dos valores na matriz do primeiro parâmetro.

Sintaxe

var novoBlob = new Blob(array, options);

Parâmetros

array
Uma Array de ArrayBuffer, ArrayBufferView, Blob, USVString, USVString, ou uma mistura de quaisquer desses objetos, que serão colocados dentro do objeto Blob. Os objetos USVString são codificados como UTF-8.
options Optional

Um objeto opcional do tipo BlobPropertyBag que pode especificar qualquer uma das seguintes propriedades:

type Optional
O tipo MIME dos dados que serão armazenados no blob. O valor predefinido é uma string vazia, ("").
endings Optional
Como interpretar os caracteres de nova linha (\n), se os dados são textos. O valor predefinido, transparent, copia os caracteres da nova linha para o blob sem os alterar. Para converter as novas linhas para a convenção nativa do sistema anfitrião, use o valor native.

Valor devolvido

Um novo objeto Blob que contém os dados especificados.

Exemplo

var dadosParaFicheiro = ['<a id="a"><b id="b">hey!</b></a>']; // uma matriz constituída por uma única DOMString
var oMeuBlob = new Blob(dadosParaFicheiro, {type : 'text/html'}); // o blob

Especificações

Especificação Estado Comentário
File API
The definition of 'Blob()' in that specification.
Working Draft Definição inicial.

Compatibilidade

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Blob() constructorChrome Full support 20Edge Full support 12Firefox Full support 13
Notes
Full support 13
Notes
Notes Before Firefox 16, the second parameter, when set to null or undefined, leads to an error instead of being handled as an empty dictionary.
IE Full support 10Opera Full support 12Safari Full support 8WebView Android Full support 37Chrome Android Full support 25Firefox Android Full support 14
Notes
Full support 14
Notes
Notes Before Firefox 16, the second parameter, when set to null or undefined, leads to an error instead of being handled as an empty dictionary.
Opera Android Full support 12Safari iOS Full support 8Samsung Internet Android Full support 1.5

Legend

Full support  
Full support
See implementation notes.
See implementation notes.

Ver também

  • A interface obsoleta BlobBuilder que este construtor substitui.