Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.with: kopia z podmienionym indeksem

with zwraca płytką, gęstą kopię z jedną wartością zastąpioną pod wskazanym dodatnim lub ujemnym indeksem.

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

Składnia

array.with(index, value)

array.with(index, value) tworzy zwykłą nową tablicę tej samej długości, zapisując value w wybranej pozycji i kopiując pozostałe wartości. Nie mutuje array, nie korzysta z Symbol.species, a referencje niezmienionych obiektów pozostają te same.

index jest konwertowany do liczby całkowitej; wartość ujemna liczy od końca, więc -1 oznacza ostatnią pozycję. Indeks mniejszy niż minus długość albo co najmniej równy długości powoduje RangeError. Dziury są odczytywane jako undefined i materializowane, dlatego wynik jest gęsty.

Metoda jest generyczna dla array-like i pochodzi z ECMAScript 2023. Odbiorca null lub undefined powoduje TypeError; błędy konwersji długości lub indeksu, getterów i proxy trapów są propagowane, a zbyt duża długość zwykłej tablicy może spowodować RangeError.

Przykłady

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

Wynik

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

Źródła