TypedArray.prototype.with()
Baseline 2023Newly available
Since July 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Die with()-Methode von TypedArray-Instanzen ist die kopierende Version der Klammernotation, um den Wert eines bestimmten Index zu ändern. Sie gibt ein neues typisiertes Array zurück, bei dem das Element an dem angegebenen Index durch den angegebenen Wert ersetzt wird. Diese Methode hat denselben Algorithmus wie Array.prototype.with().
Syntax
arrayInstance.with(index, value)
Parameter
index-
Nullbasierter Index, an dem das typisierte Array geändert wird, in eine Ganzzahl umgewandelt.
value-
Jeder Wert, der dem angegebenen Index zugewiesen werden soll.
Rückgabewert
Ein neues typisiertes Array, bei dem das Element an index durch value ersetzt wurde.
Ausnahmen
RangeError-
Wird ausgelöst, wenn
index >= array.lengthoderindex < -array.length.
Beschreibung
Siehe Array.prototype.with() für weitere Details. Diese Methode ist nicht generisch und kann nur auf typisierten Array-Instanzen aufgerufen werden.
Beispiele
Verwendung von with()
const arr = new Uint8Array([1, 2, 3, 4, 5]);
console.log(arr.with(2, 6)); // Uint8Array [1, 2, 6, 4, 5]
console.log(arr); // Uint8Array [1, 2, 3, 4, 5]
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-%typedarray%.prototype.with |