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 Verwendung der Klammernotation, um den Wert eines gegebenen Indexes zu ändern. Sie gibt ein neues Typed-Array zurück, bei dem das Element am angegebenen Index durch den angegebenen Wert ersetzt wird. Diese Methode folgt dem gleichen Algorithmus wie Array.prototype.with().
Syntax
arrayInstance.with(index, value)
Parameter
index-
Der nullbasierte Index, an dem das Typed-Array geändert werden soll, umgewandelt in eine Ganzzahl.
value-
Jeder Wert, der dem angegebenen Index zugewiesen werden soll.
Rückgabewert
Ein neues Typed-Array, bei dem das Element an index durch value ersetzt wird.
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 Typed-Array-Instanzen angewendet 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 Language Specification # sec-%typedarray%.prototype.with |
Browser-Kompatibilität
BCD tables only load in the browser