Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Array.prototype.with: kopija z zamenjanim indeksom

with vrne plitvo gosto kopijo z eno vrednostjo zamenjano na podanem pozitivnem ali negativnem indeksu.

Različica: ECMAScript 2023; example target: Node.js 24.22.2

Sintaksa

array.with(index, value)

array.with(index, value) ustvari nov navaden Array enake dolžine, zapiše value na izbrano mesto in kopira vse druge vrednosti. Ne spremeni array, ne upošteva Symbol.species in nespremenjeni objekti ohranijo iste reference.

index se pretvori v celo število; negativna vrednost šteje od konca, zato -1 izbere zadnje mesto. Indeks, manjši od negativne dolžine ali vsaj enak dolžini, sproži RangeError. Luknje se preberejo kot undefined in materializirajo, zato je rezultat gost.

Metoda je splošna za array-like in je bila standardizirana v ECMAScript 2023. Prejemnik null ali undefined sproži TypeError; napake pretvorbe dolžine ali indeksa, getterjev in proxy pasti se širijo, prevelika dolžina pa lahko prav tako povzroči RangeError.

Primeri

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); }

Rezultat

a,B,c
a,b,c
true true
2 true true 9
true

Viri