Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

TypedArray.prototype.map()

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2016 browserübergreifend verfügbar.

Die Methode map() von TypedArray-Instanzen erstellt ein neues typisiertes Array, dessen Elemente die Ergebnisse des Aufrufs einer bereitgestellten Funktion für jedes Element des aufrufenden typisierten Arrays sind. 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 des typisierten Arrays ausgeführt wird. Ihr Rückgabewert wird dem neuen typisierten Array als einzelnes Element 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 bei der Ausführung von callbackFn als this verwendet wird. Siehe iterative Methoden.

Rückgabewert

Ein neues typisiertes Array, dessen Elemente jeweils das Ergebnis der Callback-Funktion sind.

Beschreibung

Weitere Informationen finden Sie unter Array.prototype.map(). Diese Methode ist nicht generisch und kann nur auf Instanzen typisierter Arrays aufgerufen werden.

Beispiele

Ein typisiertes Array in ein typisiertes Array mit Quadratwurzeln umwandeln

Der folgende Code nimmt ein typisiertes Array und erstellt ein neues typisiertes Array, das die Quadratwurzeln der Zahlen im ursprünglichen 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 mit Zahlen mithilfe einer Funktion mit einem Argument umwandeln

Der folgende Code zeigt, wie map() funktioniert, wenn eine Funktion verwendet wird, die ein Argument benötigt. Während map() das ursprüngliche typisierte Array durchläuft, wird der Funktion automatisch jedes Element des Arrays als Argument übergeben.

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

Spezifikation
ECMAScript® 2027 Language Specification
# sec-%typedarray%.prototype.map

Browser-Kompatibilität

Siehe auch