CKTIS / JavaScript
Array.prototype.with: копие със заменен индекс
with връща плитко плътно копие с една стойност, заменена на зададен положителен или отрицателен индекс.
Версия: ECMAScript 2023; example target: Node.js 24.22.2
Синтаксис
array.with(index, value)array.with(index, value) създава нов обикновен Array със същата дължина, записва value на избраната позиция и копира другите стойности. Не променя array, игнорира Symbol.species и непроменените обекти запазват същите референции.
index се преобразува до цяло число; отрицателна стойност брои от края, затова -1 избира последната позиция. Индекс под отрицателната дължина или поне равен на дължината хвърля RangeError. Дупките се четат като undefined и се материализират, така че резултатът е плътен.
Методът е общ за array-like и е стандартизиран в ECMAScript 2023. Получател null или undefined хвърля TypeError; грешките от преобразуване на дължина или индекс, getter и proxy trap се разпространяват, а прекалено голяма дължина също може да даде RangeError.
Примери
const source = [{ id: "a" }, { id: "b" }, { id: "c" }];
const changed = source.with(-2, { id: "B" });
console.log(changed.map(item => item.id).join(","));
console.log(source.map(item => item.id).join(","));
console.log(changed !== source, changed[0] === source[0]);
const dense = [, 2].with(1, 9);
console.log(dense.length, 0 in dense, dense[0] === undefined, dense[1]);
try { [1].with(2, 0); } catch (error) { console.log(error instanceof RangeError); }Резултат
a,B,c a,b,c true true 2 true true 9 true