CKTIS / JavaScript
Array.prototype.with: kópia s nahradeným indexom
with vráti plytkú hustú kópiu s jednou hodnotou nahradenou na zadanom kladnom alebo zápornom indexe.
Verzia: ECMAScript 2023; example target: Node.js 24.22.2
Syntax
array.with(index, value)array.with(index, value) vytvorí nové bežné Array rovnakej dĺžky, zapíše value na vybranú pozíciu a skopíruje ostatné hodnoty. Nemení array, nepoužíva Symbol.species a nezmenené objekty majú rovnaké referencie.
index sa prevedie na celé číslo; záporná hodnota počíta od konca, takže -1 volí poslednú pozíciu. Index menší než záporná dĺžka alebo aspoň rovný dĺžke vyvolá RangeError. Diery sa čítajú ako undefined a materializujú, preto je výsledok hustý.
Metóda je všeobecná pre array-like a bola štandardizovaná v ECMAScript 2023. Prijímateľ null alebo undefined vyvolá TypeError; chyby prevodu dĺžky či indexu, getterov a proxy trapov sa šíria a príliš veľká dĺžka môže tiež spôsobiť RangeError.
Príklady
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); }Výsledok
a,B,c a,b,c true true 2 true true 9 true