This page was translated from English by the community.Learn more and join the MDN Web Docs community.
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 июль 2015 г..
Методset() сохраняет значения в типизированном массиве, читая значения из предоставленного массива.
In this article
Синтаксис
typedarr.set(array [,offset])typedarr.set(typedarray [,offset])
Параметры
- array
Массив, из которого необходимо скопировать значения. Все значения из исходного массива копируются в текущий массив, за исключением случая, когда длина исходного массива плюс сдвиг превышают длину текущего массива, в таких ситуациях возникает исключение.
- typedarray
Если исходный массив является типизированным массивом, то оба массива могут ссылаться на один и тот же
ArrayBuffer, т.е. быть разными представлениями (view) одного и того же ArrayBuffer; браузерскопирует исходный диапазон буфера в диапазон назначения даже в случае перекрытия диапазонов.- offsetНеобязательный
Сдвиг для текущего массива, с которого будет производиться запись исходного массива. Если значение опущено, то используется 0 (в таких ситуациях, исходный массив перезапишет значения в текущем массиве начиная с индекса 0).
Возвращаемое значение
Исключения
RangeErrorВозникает, в случае, когда с текущим сдвигом элементы будут сохраняться за пределы типизированного массива.
Примеры
>Использование метода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 ]Спецификации
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-%typedarray%.prototype.set> |