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
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:
thisArgOptional-
Ein Wert, der bei der Ausführung von
callbackFnalsthisverwendet 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.
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.
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> |