TypedArray.prototype.map()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

Die map()-Methode von TypedArray Instanzen erstellt ein neues typisiertes Array, das mit den Ergebnissen einer bereitgestellten Funktion gefüllt ist, die für jedes Element des aufrufenden typisierten Arrays ausgeführt wird. Diese Methode verwendet denselben Algorithmus wie Array.prototype.map().

Probieren Sie es aus

Syntax

js
map(callbackFn)
map(callbackFn, thisArg)

Parameter

callbackFn

Eine Funktion, die für jedes Element im typisierten Array ausgeführt wird. Der Rückgabewert dieser Funktion wird als einzelnes Element im neuen typisierten Array hinzugefügt. Die Funktion wird mit den folgenden Argumenten aufgerufen:

element

Das aktuelle Element, das im typisierten Array verarbeitet wird.

index

Der Index des aktuellen Elements, das im typisierten Array verarbeitet wird.

array

Das typisierte Array, auf dem map() angewandt wurde.

thisArg Optional

Ein Wert, der als this verwendet wird, wenn callbackFn ausgeführt wird. Siehe iterative Methoden.

Rückgabewert

Ein neues typisiertes Array, bei dem jedes Element das Ergebnis der Callback-Funktion ist.

Beschreibung

Weitere Details finden Sie unter Array.prototype.map(). Diese Methode ist nicht generisch und kann nur auf typisierten Array-Instanzen angewendet werden.

Beispiele

Zuordnung eines typisierten Arrays zu einem typisierten Array von Quadratwurzeln

Der folgende Code nimmt ein typisiertes Array und erstellt ein neues typisiertes Array, das die Quadratwurzeln der Zahlen im ersten typisierten Array enthält.

js
const numbers = new Uint8Array([1, 4, 9]);
const roots = numbers.map(Math.sqrt);
// roots is now: Uint8Array [1, 2, 3],
// numbers is still Uint8Array [1, 4, 9]

Zuordnung eines typisierten Arrays von Zahlen mit einer Funktion, die ein Argument enthält

Der folgende Code zeigt, wie map() funktioniert, wenn eine Funktion mit einem erforderlichen Argument damit verwendet wird. Das Argument wird automatisch jedem Element des typisierten Arrays zugewiesen, während map() das ursprüngliche typisierte Array durchläuft.

js
const numbers = new Uint8Array([1, 4, 9]);
const doubles = numbers.map((num) => num * 2);
// doubles is now Uint8Array [2, 8, 18]
// numbers is still Uint8Array [1, 4, 9]

Spezifikationen

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.map

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch