廃止
この機能は廃止されました。まだいくつかのブラウザーで動作するかもしれませんが、いつ削除されてもおかしくないので、使わないようにしましょう。

BlobBuilder インターフェースは、Blob オブジェクトを構築する簡単な方法を提供します。単に BlobBuilder を作成し、 append() メソッドを使ってデータのチャンクを付け足していってください。blobの生成が完了したら getBlob() メソッドを呼んで、あなたがビルダに送り込んだデータの Blob を取得してください。

注記: BlobBuilder インターフェースは非推奨です。新しく導入された Blob コンストラクタを使用してください。

メソッド概観

void append(in ArrayBuffer data);
void append(in Blob data);
void append(in String data, [optional] in String endings);
Blob getBlob([optional] in DOMString contentType);
File getFile(in DOMString name, [optional] in DOMString contentType);

メソッド

append()

生成中の Blob に対して、指定されたJavaScriptオブジェクトの内容を付け足します。もし指定した値が BlobArrayBuffer または String のいずれでもなければ、強制的に文字列に変換されたのち、blobに付け足されます。

void append(
  in ArrayBuffer data
);

void append(
  in Blob data
);


void append(
  in String data,
  [optional] in String endings
);
パラメータ
data
Blob に付け足されるデータ
endings
\n を含む文字列がどのように扱われるか指定します。指定できる値は "transparent" (終端を変更しない) または "native" (ホストOSのファイルシステムに従って終端を変更する) です。デフォルトの値は "transparent" です。

getBlob()

append() メソッドで渡したデータから生成される Blob オブジェクトを返します。

Blob getBlob(
  in DOMString contentType Optional
);
パラメータ
contentType Optional
Blob の中で返されるデータのMIMEタイプ。これは Blob オブジェクトのtype プロパティの値になります。
戻り値

BlobBuilder が生成されてから append() によって渡された全てのデータを含む Blob オブジェクト。またこのメソッドにより BlobBuilder はリセットされ、次の append() メソッド呼び出しでは、新しいの空のblobをスタートすることができます。

getFile()

File オブジェクトを返します。

File getFile(
  in DOMString name,
  [optional] in DOMString contentType
); 
パラメータ
name
ファイル名。
contentType Optional
File の中で返されるデータのMIMEタイプ。これは File オブジェクトのtype プロパティの値になります。
戻り値

File オブジェクト。

ブラウザ互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeEdge MobileAndroid 版 FirefoxAndroid 版 OperaiOS 版 SafariSamsung Internet
基本対応
非推奨非標準
Chrome 完全対応 8
接頭辞付き
完全対応 8
接頭辞付き
接頭辞付き Webkit のベンダー接頭辞が必要
Edge 完全対応 ありFirefox 未対応 ? — 18
接頭辞付き 補足
未対応 ? — 18
接頭辞付き 補足
接頭辞付き Moz のベンダー接頭辞が必要
補足 Starting in Firefox 14, using MozBlobBuilder will show a warning message in the web console that the use of MozBlobBuilder is deprecated and suggests to use Blob constructor instead.
IE 完全対応 10
接頭辞付き
完全対応 10
接頭辞付き
接頭辞付き MS のベンダー接頭辞が必要
Opera 未対応 なしSafari 未対応 なしWebView Android 完全対応 3
接頭辞付き
完全対応 3
接頭辞付き
接頭辞付き Webkit のベンダー接頭辞が必要
Chrome Android ? Edge Mobile 完全対応 ありFirefox Android 未対応 ? — 18
接頭辞付き 補足
未対応 ? — 18
接頭辞付き 補足
接頭辞付き Moz のベンダー接頭辞が必要
補足 Starting in Firefox 14, using MozBlobBuilder will show a warning message in the web console that the use of MozBlobBuilder is deprecated and suggests to use Blob constructor instead.
Opera Android 未対応 なしSafari iOS 未対応 なしSamsung Internet Android ?

凡例

完全対応  
完全対応
未対応  
未対応
実装状況不明  
実装状況不明
非標準。ブラウザー間の互換性が低い可能性があります。
非標準。ブラウザー間の互換性が低い可能性があります。
非推奨。新しいウェブサイトでは使用しないでください。
非推奨。新しいウェブサイトでは使用しないでください。
実装ノートを参照してください。
実装ノートを参照してください。
使用するには、ベンダー接頭辞または異なる名前が必要です。
使用するには、ベンダー接頭辞または異なる名前が必要です。

関連項目

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

このページの貢献者: s-onuma
最終更新者: s-onuma,