The set()
method stores multiple values in the typed array, reading input values from a specified array.
Syntax
typedarray.set(array[, offset]) typedarray.set(typedarray[, offset])
Parameters
- array
- The array from which to copy values. All values from the source array are copied into the target array, unless the length of the source array plus the offset exceeds the length of the target array, in which case an exception is thrown.
- typedarray
- If the source array is a typed array, the two arrays may share the same underlying
ArrayBuffer
; the browser will intelligently copy the source range of the buffer to the destination range. - offset Optional
- The offset into the target array at which to begin writing values from the source
array
. If you omit this value, 0 is assumed (that is, the sourcearray
will overwrite values in the target array starting at index 0).
Return value
Errors thrown
RangeError
- Thrown if the
offset
is set such as it would store beyond the end of the typed array.
Examples
Using the set
method
var buffer = new ArrayBuffer(8); var uint8 = new Uint8Array(buffer); uint8.set([1, 2, 3], 3); console.log(uint8); // Uint8Array [ 0, 0, 0, 1, 2, 3, 0, 0 ]
Specifications
Specification | Status | Comment |
---|---|---|
Typed Array Specification | Obsolete | Superseded by ECMAScript 6. |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'TypedArray.prototype.set' in that specification. |
Standard | Initial definition in an ECMA standard. |
ECMAScript Latest Draft (ECMA-262) The definition of 'TypedArray.prototype.set' in that specification. |
Living Standard |
Browser compatibility
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.
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 7 | 12 | 4 | 10 | 11.6 | 5.1 |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | 4 | Yes | Yes | 4 | 10 | 11.6 | 4.2 |