CKTIS / JavaScript
Array.prototype.with: kopie met één vervangen index
with retourneert een ondiepe dichte kopie met één waarde vervangen op de opgegeven positieve of negatieve index.
Versie: ECMAScript 2023; example target: Node.js 24.22.2
Syntax
array.with(index, value)array.with(index, value) maakt een nieuwe gewone Array met dezelfde lengte, schrijft value op de gekozen positie en kopieert alle andere waarden. Ze muteert array niet, negeert Symbol.species en ongewijzigde objecten houden dezelfde referenties.
index wordt naar een geheel getal omgezet; een negatieve waarde telt vanaf het einde, dus -1 kiest de laatste positie. Een index onder min de lengte of ten minste gelijk aan de lengte werpt RangeError. Gaten worden als undefined gelezen en gematerialiseerd, zodat het resultaat dicht is.
De methode is generiek voor array-achtige waarden en is in ECMAScript 2023 gestandaardiseerd. Een ontvanger null of undefined werpt TypeError; fouten uit lengte- of indexconversie, getters en proxytraps worden doorgegeven, en een te grote lengte kan ook RangeError geven.
Voorbeelden
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); }Resultaat
a,B,c a,b,c true true 2 true true 9 true