CKTIS / JavaScript
Array.prototype.with: kopie s nahrazeným indexem
with vrátí mělkou hustou kopii s jednou hodnotou nahrazenou na zadaném kladném nebo záporném indexu.
Verze: ECMAScript 2023; example target: Node.js 24.22.2
Syntaxe
array.with(index, value)array.with(index, value) vytvoří nové běžné Array stejné délky, zapíše value na vybranou pozici a zkopíruje ostatní hodnoty. Nemění array, nepoužívá Symbol.species a nezměněné objekty mají stejné reference.
index se převede na celé číslo; záporná hodnota počítá od konce, takže -1 volí poslední pozici. Index menší než záporná délka nebo alespoň rovný délce vyvolá RangeError. Díry se čtou jako undefined a materializují, proto je výsledek hustý.
Metoda je obecná pro array-like a byla standardizována v ECMAScript 2023. Příjemce null nebo undefined vyvolá TypeError; chyby převodu délky či indexu, getterů a proxy trapů se šíří a příliš velká délka může také způsobit RangeError.
Pří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ýsledek
a,B,c a,b,c true true 2 true true 9 true