Blob.slice() メソッドは、Blob ソースの指定したバイトの範囲のデータを含む新しい Blob オブジェクトを生成するために使用します。
ノート: ブラウザーとバージョンによっては、
slice() メソッドはベンダプレフィックスがあることに注意してください: Firefox 12 以前だと、blob.mozSlice()、Safari だと blob.webkitSlice() です。旧バージョンのベンダプレフィックスなしの slice() メソッドは構文が異なり、かつ廃止されています。構文
var blob = instanceOfBlob.slice([start [, end [, contentType]]]);
パラメーター
startOptional- 新しい
Blobに含める最初のバイトを示すBlobのインデックスです。負の数を指定した場合、文字列の末尾から最初に向かってのオフセットとして扱われます。たとえば、-10 はBlobの最後のバイトから 10 番目とみなされます。既定値は 0 です。Blobソースのサイズよりも大きい値をstartに指定した場合、サイズが 0 でデータを含まないBlobが返されます。 endOptional- 新しい
Blobに含め*ない*最初のバイトを示すBlobのインデックスです (すなわち、このインデックスのバイトは含まれません)。負の数を指定した場合、文字列の末尾から最初に向かってのオフセットとして扱われます。たとえば、-10 はBlobの最後のバイトから 10 番目とみなされます。既定値はsizeです。 contentTypeOptional- 新しい
Blobに指定するコンテンツタイプです; これはtypeプロパティの値になります。既定値は空文字です。
戻り値
Blob ソースから指定したデータを含む、新しい Blob オブジェクトです。
仕様
| 仕様 | ステータス | コメント |
|---|---|---|
| File API Blob.slice() の定義 |
草案 | 初期定義。 |
ブラウザー実装状況
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| 機能 | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| 基本対応 | ? | ? | あり | 14 | ? | ? | ? |
1. Prior to Gecko 12.0 (Firefox 12.0 / Thunderbird 12.0 / SeaMonkey 2.9), there was a bug that affected the behavior of Blob.slice(); it did not work for start and end positions outside the range of signed 64-bit values; it has now been fixed to support unsigned 64-bit values.