The SharedArrayBuffer.prototype.slice()
method returns a new SharedArrayBuffer
whose contents are a copy of this SharedArrayBuffer
's bytes from begin, inclusive, up to end, exclusive. If either begin or end is negative, it refers to an index from the end of the array, as opposed to from the beginning. This method has the same algorithm as Array.prototype.slice()
.
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
sab.slice()
sab.slice(begin)
sab.slice(begin, end)
Parameters
begin
Optional
- Zero-based index at which to begin extraction.
- A negative index can be used, indicating an offset from the end of the sequence.
slice(-2)
extracts the last two elements in the sequence.
- If
begin
is undefined, slice
begins from index 0
.
end
Optional
- Zero-based index before which to end extraction.
slice
extracts up to but not including end
.
- For example,
slice(1,4)
extracts the second element through the fourth element (elements indexed 1, 2, and 3).
- A negative index can be used, indicating an offset from the end of the sequence.
slice(2,-1)
extracts the third element through the second-to-last element in the sequence.
- If
end
is omitted, slice
extracts through the end of the sequence (sab.byteLength
).
Return value
A new SharedArrayBuffer
containing the extracted elements.
Examples
Using slice
var sab = new SharedArrayBuffer(1024);
sab.slice(); // SharedArrayBuffer { byteLength: 1024 }
sab.slice(2); // SharedArrayBuffer { byteLength: 1022 }
sab.slice(-2); // SharedArrayBuffer { byteLength: 2 }
sab.slice(0, 1); // SharedArrayBuffer { byteLength: 1 }
Specifications
Browser compatibility
| Desktop | Mobile | Server |
---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | Android webview | Chrome for Android | Firefox for Android | Opera for Android | Safari on iOS | Samsung Internet | Node.js |
---|
slice | Chrome
Full support
68-
Full support
68
-
No support
60 — 63
- Notes Chrome disabled SharedArrayBuffer on January 5, 2018 to help reduce the efficacy of speculative side-channel attacks. This was a temporary removal while mitigations were put in place.
| Edge
Full support
79-
Full support
79
-
No support
16 — 17
- Notes Support was removed to mitigate speculative execution side-channel attacks (Windows blog).
| Firefox
Full support
79-
Full support
79
-
Full support
57
- Notes Support was disabled by default to mitigate speculative execution side-channel attacks (Mozilla Security Blog).
- Disabled From version 57: this feature is behind the
javascript.options.shared_memory preference (needs to be set to true ). To change preferences in Firefox, visit about:config. -
No support
55 — 57
-
No support
46 — 55
- Disabled From version 46 until version 55 (exclusive): this feature is behind the
javascript.options.shared_memory preference (needs to be set to true ). To change preferences in Firefox, visit about:config.
| IE
No support
No | Opera
No support
No | Safari
No support
10.1 — 11 | WebView Android
No support
60 — 63-
No support
60 — 63
- Notes Chrome disabled SharedArrayBuffer on January 5, 2018 to help reduce the efficacy of speculative side-channel attacks. This is intended as a temporary measure until other mitigations are in place.
| Chrome Android
No support
60 — 63-
No support
60 — 63
- Notes Chrome disabled SharedArrayBuffer on January 5, 2018 to help reduce the efficacy of speculative side-channel attacks. This is intended as a temporary measure until other mitigations are in place.
| Firefox Android
Full support
57-
Full support
57
- Notes Support was disabled by default to mitigate speculative execution side-channel attacks (Mozilla Security Blog).
- Disabled From version 57: this feature is behind the
javascript.options.shared_memory preference (needs to be set to true ). To change preferences in Firefox, visit about:config. -
No support
55 — 57
-
No support
46 — 55
- Disabled From version 46 until version 55 (exclusive): this feature is behind the
javascript.options.shared_memory preference (needs to be set to true ). To change preferences in Firefox, visit about:config.
| Opera Android
No support
No | Safari iOS
No support
10.3 — 11 | Samsung Internet Android
No support
No-
No support
No
- Notes Chrome disabled SharedArrayBuffer on January 5, 2018 to help reduce the efficacy of speculative side-channel attacks. This is intended as a temporary measure until other mitigations are in place.
| nodejs
Full support
8.10.0 |
---|
Legend
-
Full support
- Full support
-
No support
- No support
- See implementation notes.
- See implementation notes.
- User must explicitly enable this feature.
- User must explicitly enable this feature.
See also