Blob() コンストラクタは、新たな Blob オブジェクトを返します。その blob の中身は、array という引数で与えられた値 (同士) を連結したものから構成されています。

構文

var aBlob = new Blob( array[, options]);

引数

  • array は、Blob の中に入れられることになるもの—— ArrayBuffer オブジェクト、ArrayBufferView オブジェクト、Blob オブジェクト、DOMString オブジェクト、またはそういったオブジェクトのうち任意のものを混在させたもの——からなる Array です。DOMString はUTF-8 で符号化されます。
  • options は、以下の二つの属性を指定できるオプショナルな BlobPropertyBag ディクショナリです。
    • type は、 blob の中に入れられることになる配列の中身の MIME タイプを表し、デフォルト値は "" です。
    • endings は、行末文字 \n を含む文字列をどのように書き出すべきかを指定するもので、デフォルト値は "transparent" です。endings は、次の二つの値のうちのどちらかです。すなわち、ホスト OS のファイルシステムの慣行に合うように行末文字を変更することを意味する "native"か、変更せずに行末を blob の中にそのまま格納することを意味する "transparent" です。

var aFileParts = ['<a id="a"><b id="b">hey!</b></a>']; // 一つの DOMString からなる配列
var oMyBlob = new Blob(aFileParts, {type : 'text/html'}); // blob

仕様

Specification Status Comment
File API
Blob() の定義
草案 Initial definition.

ブラウザ互換性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

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] 未サポート ? ?
in Workers ? 14.0 (14.0) 未サポート ? ?

[1] Firefox 16 よりも前だと、第 2 引数が null または undefined とされた場合には、それを空のディクショナリとして扱うのではなく、エラーとなります。

参考

  • 本コンストラクタにより取って代わられた、非推奨の  BlobBuilder も参照。

 

ドキュメントのタグと貢献者

このページの貢献者: piyo-ko
最終更新者: piyo-ko,