Урок 152 минуты чтения
copyWithin()
На этой странице
Кратко
copyWithin() копирует часть массива в другую позицию внутри того же массива, не меняет длину и мутирует исходный массив.
Вопрос
Что делает copyWithin()?
Синтаксис
arr.copyWithin(target, start, end);target- индекс, куда копировать;start- откуда начать копирование;end- где остановиться, не включая этот индекс.
Пример
const arr = [1, 2, 3, 4, 5];
arr.copyWithin(0, 3);
console.log(arr); // [4, 5, 3, 4, 5]Элементы с индексов 3 и 4 скопировались в начало.
С end
const arr = [1, 2, 3, 4, 5];
arr.copyWithin(1, 3, 5);
console.log(arr); // [1, 4, 5, 4, 5]Копируется диапазон [start, end).
Мутация и длина
const arr = [1, 2, 3];
const result = arr.copyWithin(1, 0);
console.log(result === arr); // true
console.log(arr.length); // 3Метод возвращает тот же массив и не меняет длину.
Отрицательные индексы
const arr = [1, 2, 3, 4, 5];
arr.copyWithin(-2, 0, 2);
console.log(arr); // [1, 2, 3, 1, 2]Когда встречается
copyWithin() используется редко. Он полезен для низкоуровневых преобразований массива, буферов и ситуаций, где важно менять массив на месте без выделения новой памяти.
Что важно помнить
copyWithin(target, start, end)копирует часть массива внутри него же и мутирует массив.- Длина массива не меняется: скопированное перезаписывает элементы.
- Метод нужен редко — в основном для typed arrays и низкоуровневых буферов.
- Иммутабельной версии нет: для копирования используйте
sliceи spread.
Мини-шпаргалка
| Свойство | copyWithin() |
|---|---|
| мутирует массив | да |
| меняет длину | нет |
| возвращает | тот же массив |
| копирует | внутри массива |
| диапазон | [start, end) |
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.