The Blob
interface's slice()
method
creates and returns a new Blob
object which contains data from a subset of
the blob on which it's called.
Syntax
var newBlob = blob.slice(start, end, contentType);
Parameters
start
Optional- An index into the
Blob
indicating the first byte to include in the newBlob
. If you specify a negative value, it's treated as an offset from the end of theBlob
toward the beginning. For example, -10 would be the 10th from last byte in theBlob
. The default value is 0. If you specify a value forstart
that is larger than the size of the sourceBlob
, the returnedBlob
has size 0 and contains no data. end
Optional- An index into the
Blob
indicating the first byte that will *not* be included in the newBlob
(i.e. the byte exactly at this index is not included). If you specify a negative value, it's treated as an offset from the end of theBlob
toward the beginning. For example, -10 would be the 10th from last byte in theBlob
. The default value issize
. contentType
Optional- The content type to assign to the new
Blob
; this will be the value of itstype
property. The default value is an empty string.
Return value
A new Blob
object containing the specified subset of the data contained
within the blob on which this method was called. The original blob is not altered.
Specifications
Specification | Status | Comment |
---|---|---|
File API The definition of 'Blob.slice()' in that specification. |
Working Draft | Initial definition |
Browser compatibility
BCD tables only load in the browser
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.