The Blob() constructor returns a new Blob object. The content of the blob consists of the concatenation of the values given in the parameter array.
Syntax
var aBlob = new Blob( array, options );
Parameters
- array is an
ArrayofArrayBuffer,ArrayBufferView,Blob,DOMStringobjects, or a mix of any of such objects, that will be put inside theBlob. DOMStrings are encoded as UTF-8. - options is an optional
BlobPropertyBagdictionary which may specify the following two attributes:type, with a default value of"", that represents the MIME type of the content of the array that will be put in the blob.endings, with a default value of"transparent", that specifies how strings containing the line ending character\nare to be written out. It is one of the two values:"native", meaning that line ending characters are changed to match host OS filesystem convention, or"transparent",meaning that endings are stored in the blob without change.
Example
var aFileParts = ['<a id="a"><b id="b">hey!</b></a>']; // an array consisting of a single DOMString
var oMyBlob = new Blob(aFileParts, {type : 'text/html'}); // the blob
Specification
| Specification | Status | Comment |
|---|---|---|
| File API The definition of 'Blob()' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | 20 | 13.0 (13.0) [1] | 10 | 12.10 | 8 |
| in Workers | ? | 14.0 (14.0) | ? | ? | ? |
| Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | ? | 13.0 (13.0) [1] | No support | ? | ? |
| in Workers | ? | 14.0 (14.0) | No support | ? | ? |
[1] Before Firefox 16, the second parameter, when set to null or undefined, leads to an error instead of being handled as an empty dictionary.
See also
- The deprecated
BlobBuilderwhich this constructor replaces.