Array.prototype.with
Возвращает копию массива, в которой заменён один элемент.
Доступно с: ES2023
Синтаксис
array.with(index, value)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| index | number | Индекс заменяемого элемента. Отрицательный отсчитывается от конца. |
| value | any | Новое значение. |
Возвращаемое значение
ArrayНовый массив с заменённым элементом.
Примеры
Замена элемента в копии:
const sizes = ['S', 'M', 'L'];
console.log(sizes.with(1, 'XL').join(', '));
console.log(sizes.join(', '));Результат:
S, XL, L
S, M, LЗамена последнего элемента:
console.log([1, 2, 3].with(-1, 30).join(', '));Результат:
1, 2, 30Примечания
Неизменяемая версия записи array[index] = value. Индекс за пределами массива вызывает ошибку RangeError.
См. также
- Array.prototype.toSpliced — Возвращает копию массива с удалёнными, заменёнными или вставленными элементами.
- Array.prototype.at — Возвращает элемент по индексу, поддерживает отрицательные индексы.
В учебнике
- Методы массивов — Как добавлять и удалять элементы массива в JavaScript: push, pop, shift, unshift, slice, splice, concat и join.