Web/JavaScript/Reference/Global objects/TypedArray/set

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 JavaScript engine 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 this value is omitted, 0 is assumed (that is, the source array will overwrite values in the target array starting at index 0).

Exceptions

A RangeError, if the offset is set such as it would store beyond the end of the typed array.

Examples

Using set()

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
[(ECMA-262)The definition of 'TypedArray.prototype.set' in that specification.]

Browser compatibility

Update compatibility data on GitHub

	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
`set`	Chrome Full support 7	Edge Full support 14	Firefox Full support 4	IE Full support 10	Opera Full support 11.6	Safari Full support 5.1	WebView Android Full support 4	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support 12	Safari iOS Full support 4.2	Samsung Internet Android Full support 1.0	nodejs Full support 0.10

Legend

Full support: Full support