The slice()
method returns a new ArrayBuffer
whose contents are a copy of this ArrayBuffer
's bytes from begin
, inclusive, up to end
, exclusive.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
arraybuffer.slice(begin[, end])
Parameters
begin
- Zero-based byte index at which to begin slicing.
end
Optional- Byte index before which to end slicing. If end is unspecified, the new
ArrayBuffer
contains all bytes from begin to the end of thisArrayBuffer
.
Return value
A new ArrayBuffer
object.
Description
The slice()
method copies up to, but not including, the byte indicated by the end
parameter. If either begin
or end
is negative, it refers to an index from the end of the array, as opposed to from the beginning.
The range specified by the begin
and end
parameters is clamped to the valid index range for the current array. If the computed length of the new ArrayBuffer
would be negative, it is clamped to zero.
Examples
Copying an ArrayBuffer
const buf1 = new ArrayBuffer(8); const buf2 = buf1.slice(0);
Specifications
Specification |
---|
ECMAScript (ECMA-262) The definition of 'ArrayBuffer.prototype.slice' in that specification. |
Browser compatibility
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
slice | Chrome Full support 17 | Edge Full support 12 | Firefox
Full support
12
| IE Full support 11 | Opera Full support 12.1 | Safari Full support 6 | WebView Android Full support ≤37 | Chrome Android Full support 18 | Firefox Android
Full support
14
| Opera Android Full support 12.1 | Safari iOS Full support 6 | Samsung Internet Android Full support 1.0 | nodejs Full support 0.12 |
Legend
- Full support
- Full support
- See implementation notes.
- See implementation notes.