TypedArray.prototype.set()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Метод set() сохраняет значения в типизированном массиве, читая значения из предоставленного массива.

Синтаксис

typedarr.set(array [,offset])
typedarr.set(typedarray [,offset])

Параметры

array

Массив, из которого необходимо скопировать значения. Все значения из исходного массива копируются в текущий массив, за исключением случая, когда длина исходного массива плюс сдвиг превышают длину текущего массива, в таких ситуациях возникает исключение.

typedarray

Если исходный массив является типизированным массивом, то оба массива могут ссылаться на один и тот же ArrayBuffer, т.е. быть разными представлениями (view) одного и того же ArrayBuffer; браузер скопирует исходный диапазон буфера в диапазон назначения даже в случае перекрытия диапазонов.

offset Необязательный

Сдвиг для текущего массива, с которого будет производиться запись исходного массива. Если значение опущено, то используется 0 (в таких ситуациях, исходный массив перезапишет значения в текущем массиве начиная с индекса 0).

Возвращаемое значение

undefined.

Исключения

RangeError

Возникает, в случае, когда с текущим сдвигом элементы будут сохраняться за пределы типизированного массива.

Примеры

Использование метода set

js
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 ]

Спецификации

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.set

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также