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

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 オブジェクト。

ブラウザ互換性

機能ChromeEdgeFirefoxInternet ExplorerOperaSafari
基本対応8 Webkit あり あり — 18 Moz 110 MS なし なし
機能Android webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
基本対応3 Webkit ? あり あり — 18 Moz 1 なし なし ?

1. 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.

関連項目

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

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