JavaScript Array map() Methode

Array 对象参考手册JavaScript Array-Objekt

Beispiel

Gibt ein Array zurück, dessen Elemente die Quadratwurzeln der ursprünglichen Array-Elemente sind:

var numbers = [4, 9, 16, 25];

function myFunction() {
    x = document.getElementById("demo")
    x.innerHTML = numbers.map(Math.sqrt);
}

Das Ausgabeergebnis ist:

2,3,4,5

Selbst ausprobieren »

Definition und Verwendung

Die map()-Methode gibt ein neues Array zurück, dessen Elemente die Werte sind, die durch Aufrufen einer Funktion auf den Elementen des ursprünglichen Arrays erhalten werden.

Die map()-Methode verarbeitet Elemente in der Reihenfolge der Elemente des ursprünglichen Arrays.

Hinweis:map() überprüft keine leeren Arrays.

Hinweis:map() ändert das ursprüngliche Array nicht.


Browser-Unterstützung

Die Zahlen in der Tabelle geben die erste Browserversion an, die die Methode vollständig unterstützt.

Methode
map() Ja 9 1.5 Ja Ja

Syntax

array.map(function(currentValue,index,arr), thisValue)

Parameterdetails

Parameter Beschreibung
function(currentValue, index,arr) Erforderlich. Eine Funktion, die für jedes Element im Array ausgeführt wird.
Funktionsparameter:
Parameter Beschreibung
currentValue Erforderlich. Der Wert des aktuellen Elements.
index Optional. Der Index des aktuellen Elements.
arr Optional. Das Array-Objekt, zu dem das aktuelle Element gehört.
thisValue Optional. Ein Objekt, das als "this" verwendet wird, wenn der Callback ausgeführt wird, und das an die Funktion übergeben wird.
Wenn thisValue weggelassen wird oder null oder undefined übergeben wird, ist this in der Callback-Funktion das globale Objekt.

Technische Details

Rückgabewert: Gibt ein neues Array zurück, dessen Elemente die Werte sind, die durch Aufrufen einer Funktion auf den Elementen des ursprünglichen Arrays erhalten werden.
JavaScript-Version: 1.6

Weitere Beispiele

Beispiel

Multipliziere jedes Element im Array mit dem im Eingabefeld angegebenen Wert und gib ein neues Array zurück:

var numbers = [65, 44, 12, 4];

Funktion multiplyArrayElement(num) {
    return num * document.getElementById("multiplyWith").value;
}

Funktion myFunction() {
    document.getElementById("demo").innerHTML = numbers.map(multiplyArrayElement);
}

Selbst ausprobieren »

Array 对象参考手册JavaScript Array-Objekt

Andere Erweiterungen