Array.prototype.toSpliced
Возвращает копию массива с удалёнными, заменёнными или вставленными элементами.
Доступно с: ES2023
Синтаксис
array.toSpliced(start, deleteCount, item1, /* … */)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| start | number | Позиция, с которой начинается изменение. |
| deleteCount | number | Необязательный. Сколько элементов удалить. |
| item1, … | any | Необязательные. Элементы, которые вставляются на место удалённых. |
Возвращаемое значение
ArrayНовый массив с изменениями.
Примеры
Удаление элемента без изменения исходного массива:
const letters = ['a', 'b', 'c'];
console.log(letters.toSpliced(1, 1).join(''));
console.log(letters.join(''));Результат:
ac
abcВставка в середину:
console.log([1, 4].toSpliced(1, 0, 2, 3).join(', '));Результат:
1, 2, 3, 4Примечания
В отличие от splice(), возвращает не удалённые элементы, а новый массив целиком.
См. также
- Array.prototype.splice — Удаляет, заменяет или вставляет элементы в середину массива.
- Array.prototype.with — Возвращает копию массива, в которой заменён один элемент.
- Array.prototype.slice — Возвращает часть массива.
Вопросы и ответы по теме
В учебнике
- Методы массивов — Как добавлять и удалять элементы массива в JavaScript: push, pop, shift, unshift, slice, splice, concat и join.