WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.with: Kopie mit ersetztem Index

with gibt eine flache dichte Kopie zurück, in der ein Wert an einem positiven oder negativen Index ersetzt ist.

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

Syntax

array.with(index, value)

array.with(index, value) erstellt ein neues gewöhnliches Array gleicher Länge, schreibt value an die gewählte Position und kopiert alle anderen Werte. Es mutiert array nicht, beachtet Symbol.species nicht und unveränderte Objekte behalten dieselben Referenzen.

index wird ganzzahlig umgewandelt; ein negativer Wert zählt vom Ende, daher wählt -1 die letzte Position. Ein Index kleiner als minus die Länge oder mindestens gleich der Länge löst RangeError aus. Lücken werden als undefined gelesen und materialisiert, sodass das Ergebnis dicht ist.

Die Methode ist für array-ähnliche Werte generisch und stammt aus ECMAScript 2023. Ein Empfänger null oder undefined ergibt TypeError; Fehler der Längen- oder Indexkonvertierung, von Gettern und Proxy-Traps werden weitergegeben, und eine zu große Länge kann ebenfalls RangeError erzeugen.

Beispiele

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

Ergebnis

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

Quellen