JavaScript метод copyWithin()

Определение и применение

JavaScript метод copyWithin() позволяет скопировать элементы массива (в зависимости от их индекса) и вставить их в тот же массив, заменяя определенные элементы массива (в зависимости от их индекса), длина массива при этом не изменяется.

Обращаю Ваше внимание, что метод copyWithin() изменяет существующий массив, а не возвращает новый.

Поддержка браузерами

Метод	Chrome	Firefox	Opera	Safari	IExplorer	Edge
`copyWithin()`	45.0	32.0	32.0	9.0	Нет	12.0

JavaScript синтаксис:

array.copyWithin( target, start )

// с указанием конечного индекса для вставки
array.copyWithin( target, start, end )

Версия JavaScript

ECMAScript 2015 (6th Edition)

Значения параметров

Параметр	Описание
target	Начальный индекс позиции целевого элемента, куда будут копироваться элементы массива. Обязательное значение. Допускается использование отрицательных значений, в этом случае индекс с которого будет произведено копирование будет расчитан по следующей формуле: `length` (длина массива) + `target.`
start	Целое число, определяющее индекс массива, с которого будут скопированы элементы массива. Обязательное значение. Допускается использование отрицательных значений, в этом случае индекс с которого будет произведено копирование будет расчитан по следующей формуле: `length` (длина массива) + `start.`
end	Целое число, определяющее индекс массива, которым заканчивается копирование элементов массива. Необязательное значение, если не указано, то будут скопированы все элементы от начальной позиции (start) и до конца массива. Допускается использование отрицательных значений, в этом случае индекс до которого будет произведено копирование будет расчитан по следующей формуле: `length` (длина массива) + `end.`

Пример использования

var x = [1, 2, 3, "a", "b", "c"]; // инициализируем переменную, содержащую массив

x.copyWithin( 0, 3 ); // возвращаемое значение ["a", "b", "c", "a", "b", "c"]
x.copyWithin( 3, 0 ); // возвращаемое значение [1, 2, 3, 1, 2, 3]
x.copyWithin( -2, 3 ); // возвращаемое значение [1, 2, 3, "a", "a", "b"]
x.copyWithin( 0, 3, 4 ); // возвращаемое значение ["a", 2, 3, "a", "b", "c"]
x.copyWithin( 0, 3, 5 ); // возвращаемое значение ["a", "b", 3, "a", "b", "c"]
x.copyWithin( 0, -2, -1 ); // возвращаемое значение ["b", 2, 3, "a", "b", "c"]

JavaScript Array