Das Map Objekt ist eine einfache Schlüssel/Wert Zuordnung. Jeder Wert (Sowohl Objekte, als auch  primitive Datentypen) kann als Schlüssel/Wert verwendet werden.

Syntax

new Map([iterable])

Parameter

iterable

Der Parameter iterable ist ein Array oder anderes iterierbares Objekt, dessen Elemente Schlüssel-Wert Paare (2-Element Arrays) sind. Jedes Schlüssel-Wert Paar wird der neuen Map hinzugefügt. null wird als undefined behandelt.

Beschreibung

Ein Map Object iteriert in der Reihenfolge des Einfügens über seine Elemente — eine for...of Schleife gibt ein array mit [key, value] für jede Iteration zurück.

Es ist festzuhalten, dass eine Map, bestehend aus objects, insbesondere ein "dictionary of dictionaries", nur nach der Einfügereihenfolge angelegt wird, die zufällig und ungeordnet ist.

Schlüsselvergleich

Der Schlüsselvergleich basiert auf dem "gleicher-Wert" Algorithmus: NaN wird als gleich mit einer anderen NaN angesehen, (trotz dem, dass NaN !== NaN) und alle anderen Werte müssen Typ- und Wert identisch, wie beim === Operator, sein. In der aktuellen ECMAScript Spezifikation werden -0 und +0 als gleich behandelt, auch wenn dies in früheren Entwürfen anders war. Details dazu sind der Tabelle browser compatibility zu entnehmen. 

Objects und Maps im Vergleich

Objects und Maps haben einige gemeinsame Eigenschaften. In beiden lassen sich Schlüssel Werten zuordnen, diese Werte wiederfinden, Schlüssel löschen und herausfinden ob etwas unter einem bestimmten Schlüssel gespeichert ist. Aus diesem Grund (und weil es keine spracheigenen Alternativen gab), wurden früher Objects als Maps benutzt. Doch es gibt bedeutende Unterschiede zwischen diesen beiden Strukturen, die es in verschiedenen Fällen zu beachten gilt:

  • Die Schlüssel eines Object sind Strings und Symbols, während sie bei einer Map jeglichen Wert haben können. Inklusive functions, objects, und alle primitive.
  • Die Grösse einer Map lässt sich einfach über die size Eigenschaft ermitteln, während die Zahl der Eigenschaften in einem Object erst manuell herausgefunden werden muss.
  • Eine Map ist iterierbar, wohingegen das iterieren über ein Object es erfordert, dass man dessen Schlüssel temporär extrahiert und dann über diese iteriert.
  • Ein Object hat einen Prototypen mit default-Schlüsseln in seiner map, die mit den Namen selbst angelegter Schlüssel kollidieren können, wenn man nicht aufpasst. Seit  ES5 lässt sich dies durch die Anweisung map = Object.create(null) umgehen, es wird aber selten verwendet.
  • Eine Map bietet in Szenarien mit hochfrequentem Einfügen und Löschen von Schlüssel-Wert Paaren ein besseres Laufzeitverhalten als Objects.

Eigenschaften

Map.length
Der Wert von length beträgt 0.
get Map[@@species]
Die Konstruktor-Funktion, zum erzeugen abgeleiteter Objekte.
Map.prototype
Repräsentiert den Prototyp für den Map Konstruktor. Erlaubt das hinzufügen von Eigenschaften zu allen Map Objekten.

Map Instanzen

Alle Map Instanzen erben von Map.prototype.

Eigenschaften

Map.prototype.constructor
Gibt die Funktion zurück, die einen Instanzenprototype erstellt. Der Standardwert ist die Map Funktion.
Map.prototype.size
Gibt die Anzahl an Schlüssel/Werte-Paaren in dem Map Objekt zurück.

Methoden

Map.prototype.clear()
Entfernt alle Schlüssel/Werte-Paare von dem Map Objekt.
Map.prototype.delete(schlüssel)
Gibt true zurück, wenn ein Element im Map Objekt existiert und gelöscht wird, oder false wenn das Element nicht existiert. Map.prototype.has(schlüssel) wird danach false zurückgeben.
Map.prototype.entries()
Gibt ein neues Iterator Objekt mit allen [Schlüssel, Wert] Paaren als Array von jedem Element in dem Map Objekt in Einfügereihenfolge zurück.
Map.prototype.forEach(callbackFn[, thisArg])
Ruft callbackFn einmal für jedes Schlüssel/Wert Paar in dem Map Objekt in der Einfügereihenfolge aus. Wenn ein thisArg Parameter angegeben ist, wird dieser als this für jeden Funktionsaufruf benutzt.
Map.prototype.get(schlüssel)
Gibt den Wert zu dem zugehörigen schlüssel zurück oder undefined wenn dieser nicht existiert.
Map.prototype.has(schlüssel)
Gibt einen boolean zurück, der angibt, ob ein Wert mit den shclüssel in einem Map Objekt vorhanden ist oder nicht.
Map.prototype.keys()
Gibt ein neues Iterator Objekt mit allen Schlüsseln von jedem Element in dem Map Objekt in Einfügereihenfolge zurück.
Map.prototype.set(schlüssel, wert)
Setzt den wert für einen schlüssel im Map Objekt. Gibt das Map Objekt zurück.
Map.prototype.values()
Gibt ein neues Iterator Objekt mit allen Werten von jedem Element in dem Map Objekt in Einfügereihenfolge zurück.
Map.prototype[@@iterator]()
Gibt ein neues Iterator Objekt mit allen [Schlüssel, Wert] Paaren als Array von jedem Element in dem Map Objekt in Einfügereihenfolge zurück.

Beispiele

Einsatz vom Map Objekt

var myMap = new Map();

var keyString = "ein string",
    keyObj = {},
    keyFunc = function () {};

// setting the values
myMap.set(keyString, "value associated with 'ein string'");
myMap.set(keyObj, "value associated with keyObj");
myMap.set(keyFunc, "value associated with keyFunc");

myMap.size; // 3

// getting the values
myMap.get(keyString);    // "value associated with 'ein string'"
myMap.get(keyObj);       // "value associated with keyObj"
myMap.get(keyFunc);      // "value associated with keyFunc"

myMap.get("ein string");   // "value associated with 'ein string'"
                         // because keyString === 'ein string'
myMap.get({});           // undefined, because keyObj !== {}
myMap.get(function() {}) // undefined, because keyFunc !== function () {}

Benutzung von NaN als Map Schlüssel

NaN kann auch als Schlüssel benutzt werden. Auch wenn jede NaN nicht gleich zu sich selbst ist, (NaN !== NaN is true), funktioniert das folgende Beispiel, da jede NaNs ununterscheidbar von jeder anderen ist:

var myMap = new Map();
myMap.set(NaN, "not a number");

myMap.get(NaN); // "not a number"

var otherNaN = Number("foo");
myMap.get(otherNaN); // "not a number"

Iterieren über Maps mit for..of

über Maps kann mit der for..of Schleife iteriert werden:

var myMap = new Map();
myMap.set(0, "zero");
myMap.set(1, "one");
for (var [key, value] of myMap) {
  console.log(key + " = " + value);
}
// 0 = zero
// 1 = one

for (var key of myMap.keys()) {
  console.log(key);
}
// 0
// 1

for (var value of myMap.values()) {
  console.log(value);
}
// zero
// one

for (var [key, value] of myMap.entries()) {
  console.log(key + " = " + value);
}
// 0 = zero
// 1 = one

Integration von Maps mit forEach()

über Maps kann mit der forEach() method iteriert werden:

myMap.forEach(function(value, key) {
  console.log(key + " = " + value);
}, myMap)
// Will show 2 logs; first with "0 = zero" and second with "1 = one"

Relation mit Array Objekten

var kvArray = [['key1', 'value1'], ['key2', 'value2']];

// Use the regular Map constructor to transform a 2D key-value Array into a map
var myMap = new Map(kvArray);

myMap.get('key1'); // returns "value1"

// Use the Array.from function to transform a map into a 2D key-value Array
console.log(Array.from(myMap)); // Will show you exactly the same Array as kvArray

// Or use the keys or values iterators and convert them to an array
console.log(Array.from(myMap.keys())); // Will show ["key1", "key2"]

Spezifikationen

Spezifikation Status Kommentar
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Map' in dieser Spezifikation.
Standard Initiale Definition.
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'Map' in dieser Spezifikation.
Entwurf  

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidEdge MobileFirefox für AndroidOpera für AndroidiOS SafariSamsung InternetNode.js
Grundlegende UnterstützungChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 13IE Vollständige Unterstützung 11Opera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 14Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12
Vollständige Unterstützung 0.12
Vollständige Unterstützung 0.10
Deaktiviert
Deaktiviert From version 0.10: this feature is behind the --harmony runtime flag.
new Map(iterable)Chrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 13IE Keine Unterstützung NeinOpera Vollständige Unterstützung 25Safari Vollständige Unterstützung 9WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 14Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 9Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12
new Map(null)Chrome Vollständige Unterstützung JaEdge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 37IE Vollständige Unterstützung 11Opera Vollständige Unterstützung JaSafari Vollständige Unterstützung 9WebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung JaEdge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 37Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung 9Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12
Vollständige Unterstützung 0.12
Vollständige Unterstützung 0.10
Deaktiviert
Deaktiviert From version 0.10: this feature is behind the --harmony runtime flag.
Map() without new throwsChrome Vollständige Unterstützung JaEdge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 42IE Vollständige Unterstützung 11Opera Vollständige Unterstützung JaSafari Vollständige Unterstützung 9WebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung JaEdge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 42Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung 9Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12
Key equality for -0 and 0Chrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 29IE Keine Unterstützung NeinOpera Vollständige Unterstützung 25Safari Vollständige Unterstützung 9WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 29Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 9Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 4.0.0
clearChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 19IE Vollständige Unterstützung 11Opera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 19Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12
deleteChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 13IE Vollständige Unterstützung 11Opera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 14Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12
Vollständige Unterstützung 0.12
Vollständige Unterstützung 0.10
Deaktiviert
Deaktiviert From version 0.10: this feature is behind the --harmony runtime flag.
entriesChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 20IE Keine Unterstützung NeinOpera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 20Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12
forEachChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 25IE Vollständige Unterstützung 11Opera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 25Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12
getChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 13IE Vollständige Unterstützung 11Opera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 14Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung Ja
hasChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 13IE Vollständige Unterstützung 11Opera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 14Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung Ja
keysChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 20IE Keine Unterstützung NeinOpera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 20Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12
prototypeChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 13IE Vollständige Unterstützung 11Opera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 14Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung Ja
setChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 13IE Teilweise Unterstützung 11
Hinweise
Teilweise Unterstützung 11
Hinweise
Hinweise Returns 'undefined' instead of the 'Map' object.
Opera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 14Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung Ja
sizeChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 19
Hinweise
Vollständige Unterstützung 19
Hinweise
Hinweise From Firefox 13 to Firefox 18, the size property was implemented as a Map.prototype.size() method, this has been changed to a property in later versions conform to the ECMAScript 2015 specification.
IE Vollständige Unterstützung 11Opera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 19
Hinweise
Vollständige Unterstützung 19
Hinweise
Hinweise From Firefox 13 to Firefox 18, the size property was implemented as a Map.prototype.size() method, this has been changed to a property in later versions conform to the ECMAScript 2015 specification.
Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12
valuesChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 20IE Keine Unterstützung NeinOpera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung 38Chrome Android Vollständige Unterstützung 38Edge Mobile Vollständige Unterstützung 12Firefox Android Vollständige Unterstützung 20Opera Android Vollständige Unterstützung 25Safari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12
@@iteratorChrome Vollständige Unterstützung JaEdge Vollständige Unterstützung JaFirefox Vollständige Unterstützung 36
Vollständige Unterstützung 36
Keine Unterstützung 27 — 36
Hinweise Alternativer Name
Hinweise A placeholder property named @@iterator is used.
Alternativer Name Verwendet den nicht standardisierten Namen: @@iterator
Keine Unterstützung 17 — 27
Hinweise Alternativer Name
Hinweise A placeholder property named iterator is used.
Alternativer Name Verwendet den nicht standardisierten Namen: iterator
IE Keine Unterstützung NeinOpera Vollständige Unterstützung JaSafari Vollständige Unterstützung JaWebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung JaEdge Mobile Vollständige Unterstützung JaFirefox Android Vollständige Unterstützung 36
Vollständige Unterstützung 36
Keine Unterstützung 27 — 36
Hinweise Alternativer Name
Hinweise A placeholder property named @@iterator is used.
Alternativer Name Verwendet den nicht standardisierten Namen: @@iterator
Keine Unterstützung 17 — 27
Hinweise Alternativer Name
Hinweise A placeholder property named iterator is used.
Alternativer Name Verwendet den nicht standardisierten Namen: iterator
Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung JaSamsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12
@@speciesChrome Vollständige Unterstützung 51Edge Vollständige Unterstützung 13Firefox Vollständige Unterstützung 41IE Keine Unterstützung NeinOpera Vollständige Unterstützung 38Safari Vollständige Unterstützung 10WebView Android Vollständige Unterstützung 51Chrome Android Vollständige Unterstützung 51Edge Mobile Vollständige Unterstützung 13Firefox Android Vollständige Unterstützung 41Opera Android Vollständige Unterstützung 38Safari iOS Vollständige Unterstützung 10Samsung Internet Android Vollständige Unterstützung 5.0nodejs Vollständige Unterstützung 6.5.0
Vollständige Unterstützung 6.5.0
Vollständige Unterstützung 6.0.0
Deaktiviert
Deaktiviert From version 6.0.0: this feature is behind the --harmony runtime flag.
@@toStringTagChrome Vollständige Unterstützung 44Edge Keine Unterstützung NeinFirefox Keine Unterstützung NeinIE Keine Unterstützung NeinOpera Keine Unterstützung NeinSafari Keine Unterstützung NeinWebView Android Vollständige Unterstützung 44Chrome Android Vollständige Unterstützung 44Edge Mobile Keine Unterstützung NeinFirefox Android Keine Unterstützung NeinOpera Android Keine Unterstützung NeinSafari iOS Keine Unterstützung NeinSamsung Internet Android Vollständige Unterstützung 4.0nodejs Keine Unterstützung Nein

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Teilweise Unterstützung  
Teilweise Unterstützung
Keine Unterstützung  
Keine Unterstützung
Siehe Implementierungshinweise.
Siehe Implementierungshinweise.
Benutzer muss dieses Feature explizit aktivieren.
Benutzer muss dieses Feature explizit aktivieren.
Verwendet einen nicht standardisierten Namen.
Verwendet einen nicht standardisierten Namen.

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

Schlagwörter: 
Mitwirkende an dieser Seite: kdex, Flonk, schlagi123, the-bluesnik, GinoHereIam, Chris-CR, Fearodin
Zuletzt aktualisiert von: kdex,