TypedArray.prototype.copyWithin()

Метод copyWithin() экземпляров TypedArray выполняет поверхностное копирование части этого типизированного массива в другое место того же типизированного массива и возвращает этот типизированный массив, не изменяя его длины. Этот метод использует тот же алгоритм, что и Array.prototype.copyWithin().

Попробовать

const uint8 = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]);

// Insert position, start position, end position
uint8.copyWithin(3, 1, 3);

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

Синтаксис

copyWithin(target, start)
copyWithin(target, start, end)

Параметры

target

Нулевой индекс, с которого начинается копирование последовательности, преобразованный в целое число. Это соответствует месту, куда будет скопирован элемент с индексом start, а все элементы между start и end копируются в последующие индексы.

start

Нулевой индекс, с которого начинается копирование элементов, преобразованный в целое число.

end Необязательно

Нулевой индекс, на котором заканчивается копирование элементов, преобразованный в целое число. copyWithin() копирует элементы до, но не включая end.

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

Изменённый типизированный массив.

Описание

Подробнее см. Array.prototype.copyWithin(). Этот метод не является универсальным и может быть вызван только на экземплярах типизированных массивов.

Примеры

Использование copyWithin()

const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);
uint8.set([1, 2, 3]);
console.log(uint8); // Uint8Array [ 1, 2, 3, 0, 0, 0, 0, 0 ]
uint8.copyWithin(3, 0, 3);
console.log(uint8); // Uint8Array [ 1, 2, 3, 1, 2, 3, 0, 0 ]

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

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

См. также

• Полифил TypedArray.prototype.copyWithin в core-js
• Руководство по типизированным массивам JavaScript
• TypedArray
• Array.prototype.copyWithin()