Die map()-Methode von TypedArray-Instanzen erstellt ein neues typisiertes Array, das mit den Ergebnissen einer bereitgestellten Funktion gefüllt ist, die auf jedes Element im aufrufenden typisierten Array angewendet wird. Diese Methode hat 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

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 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() aufgerufen 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

Siehe Array.prototype.map() für mehr Details. Diese Methode ist nicht generisch und kann nur auf typisierten Array-Instanzen aufgerufen werden.

Beispiele

Mapping 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.

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]

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

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 iteriert.

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

Browser-Kompatibilität

Siehe auch

• Polyfill von TypedArray.prototype.map in core-js
• JavaScript typisierte Arrays Leitfaden
• TypedArray
• TypedArray.prototype.forEach()
• TypedArray.from()
• Array.prototype.map()
• Map