Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Array.prototype.with: kopija sa zamijenjenim indeksom

with vraća plitku gustu kopiju s jednom vrijednošću zamijenjenom na zadanom pozitivnom ili negativnom indeksu.

Verzija: ECMAScript 2023; example target: Node.js 24.22.2

Sintaksa

array.with(index, value)

array.with(index, value) stvara novi obični Array iste duljine, zapisuje value na odabrano mjesto i kopira ostale vrijednosti. Ne mijenja array, zanemaruje Symbol.species i nepromijenjeni objekti zadržavaju iste reference.

index se pretvara u cijeli broj; negativna vrijednost broji od kraja, pa -1 bira posljednje mjesto. Indeks manji od negativne duljine ili barem jednak duljini baca RangeError. Rupe se čitaju kao undefined i materijaliziraju, pa je rezultat gust.

Metoda je generička za array-like i standardizirana je u ECMAScript 2023. Primatelj null ili undefined baca TypeError; pogreške pretvorbe duljine ili indeksa, gettera i proxy zamki šire se, a prevelika duljina također može izazvati RangeError.

Primjeri

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

Izvori