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.length oder index < -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

Browser-Kompatibilität

Siehe auch

• Polyfill von TypedArray.prototype.with in core-js
• JavaScript typisierte Arrays Leitfaden
• TypedArray.prototype.toReversed()
• TypedArray.prototype.toSorted()
• TypedArray.prototype.at()
• Array.prototype.with()