JavaScript метод copyWithin()ECMAScript 2015

JavaScript Array

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

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


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


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

МетодChrome
Chrome
Firefox
Firefox
Opera
Opera
Safari
Safari
Internet Explorer
IExplorer
Microsoft Edge
Edge
copyWithin()ECMAScript 201545.032.032.09.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 ); // возвращаемое значение [1, 2, 3, 1, 2, 3]
x.copyWithin( 3, 0 ); // возвращаемое значение ["a", "b", "c", "a", "b", "c"]
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