Array.prototype.with()

index

Nullbasierter Index, an dem das Array geändert wird, in eine Ganzzahl umgewandelt.

• Ein negativer Index zählt vom Ende des Arrays zurück — wenn -array.length <= index < 0, wird index + array.length verwendet.
• Wenn der Index nach der Normalisierung außerhalb der Grenzen liegt, wird ein RangeError ausgelöst.

value

Jeder Wert, der dem angegebenen Index zugewiesen wird.

Ein neues Array, bei dem das Element an index durch value ersetzt wird.

RangeError

Wird ausgelöst, wenn index >= array.length oder index < -array.length.

Die with()-Methode ändert den Wert eines bestimmten Index im Array und gibt ein neues Array zurück, bei dem das Element am angegebenen Index durch den angegebenen Wert ersetzt wird. Das ursprüngliche Array wird nicht verändert. Dies ermöglicht es Ihnen, Array-Methoden während der Manipulationen zu verketten.

Durch das Kombinieren von with() mit at() können Sie ein Array sowohl mit negativen Indizes schreiben als auch lesen (jeweils).

Die with()-Methode erzeugt niemals ein lückenhaftes Array. Wenn das Quellarray lückenhaft ist, werden die leeren Plätze im neuen Array durch undefined ersetzt.

Die with()-Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length Eigenschaft hat und integerbasierte Schlüsselwerteigenschaften.

Mit der with()-Methode können Sie ein einzelnes Element in einem Array aktualisieren und dann andere Array-Methoden anwenden.

const arr = [1, 2, 3, 4, 5];
console.log(arr.with(2, 6).map((x) => x ** 2)); // [1, 4, 36, 16, 25]

Die with()-Methode erzeugt immer ein dichtes Array.

const arr = [1, , 3, 4, , 6];
console.log(arr.with(0, 2)); // [2, undefined, 3, 4, undefined, 6]

Die with()-Methode erstellt und gibt ein neues Array zurück. Sie liest die length-Eigenschaft von this und greift dann auf jede Eigenschaft zu, deren Schlüssel eine nicht negative Ganzzahl ist, die kleiner als length ist. Während jede Eigenschaft von this zugegriffen wird, wird das Array-Element, dessen Index gleich dem Schlüssel der Eigenschaft ist, auf den Wert der Eigenschaft gesetzt. Schließlich wird der Array-Wert bei index auf value gesetzt.

const arrayLike = {
  length: 3,
  unrelated: "foo",
  0: 5,
  2: 4,
  3: 3, // ignored by with() since length is 3
};
console.log(Array.prototype.with.call(arrayLike, 0, 1));
// [ 1, undefined, 4 ]

• Polyfill von Array.prototype.with in core-js
• Leitfaden zu indizierten Sammlungen
• Array.prototype.toReversed()
• Array.prototype.toSorted()
• Array.prototype.toSpliced()
• Array.prototype.at()
• TypedArray.prototype.with()