TypedArray.prototype.set()

The set() method of {{jsxref("TypedArray")}} instances stores multiple values in the typed array, reading input values from a specified array.

{{InteractiveExample("JavaScript Demo: TypedArray.prototype.set()")}}

```js interactive-example // Create an ArrayBuffer with a size in bytes const buffer = new ArrayBuffer(8); const uint8 = new Uint8Array(buffer);

// Copy the values into the array starting at index 3 uint8.set([1, 2, 3], 3);

console.log(uint8); // Expected output: Uint8Array [0, 0, 0, 1, 2, 3, 0, 0]

## Syntax

```js-nolint
set(array)
set(array, targetOffset)

set(typedarray)
set(typedarray, targetOffset)

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 target 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 {{jsxref("ArrayBuffer")}}; the JavaScript engine will intelligently copy the source range of the buffer to the destination range.
• targetOffset {{optional_inline}}
• : 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).

Return value#

None ({{jsxref("undefined")}}).

Exceptions#

• {{jsxref("RangeError")}}
• : Thrown in one of the following cases:
  • An element will be stored beyond the end of the typed array, either because targetOffset is too large or because array or typedarray is too large.
  • targetOffset is negative.

Examples#

Using set()#

const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);

uint8.set([1, 2, 3], 3);

console.log(uint8); // Uint8Array [ 0, 0, 0, 1, 2, 3, 0, 0 ]

Specifications#

{{Specifications}}

Browser compatibility#

{{Compat}}

See also#

• Polyfill of TypedArray.prototype.set in core-js
• JavaScript typed arrays guide
• {{jsxref("TypedArray")}}
• {{jsxref("ArrayBuffer")}}