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 wird, die auf jedes Element des aufrufenden typisierten Arrays angewendet wird. Diese Methode verwendet denselben Algorithmus wie Array.prototype.map().

Probieren Sie es aus

const uint8 = new Uint8Array([25, 36, 49]);
const roots = uint8.map(Math.sqrt);

console.log(roots);
// Expected output: Uint8Array [5, 6, 7]

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 wird als einzelnes Element in das neue typisierte Array eingefü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() aufgerufen wurde.

thisArg Optional

Ein Wert, der als this beim Ausführen von callbackFn verwendet wird. Siehe iterative Methoden.

Rückgabewert

Ein neues typisiertes Array, bei dem jedes Element das Ergebnis der Rückruffunktion ist.

Beschreibung

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

Beispiele

Ein typisiertes Array zu einem typisierten Array von Quadratwurzeln abbilden

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]

Ein typisiertes Array von Zahlen mithilfe einer Funktion mit einem Argument abbilden

Der folgende Code zeigt, wie map() funktioniert, wenn eine Funktion, die ein Argument erfordert, damit verwendet wird. Das Argument wird automatisch jedem Element des typisierten Arrays zugewiesen, während map() durch das ursprüngliche typisierte Array schleift.

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® 2025 Language Specification
# sec-%typedarray%.prototype.map

Browser-Kompatibilität

Siehe auch