CKTIS / JavaScript
Map – eine Schlüssel-Wert-Sammlung
Map speichert eindeutige Schlüssel beliebigen Typs zusammen mit den zugehörigen Werten. Einträge lassen sich lesen und löschen; außerdem kann geprüft werden, ob ein Schlüssel vorhanden ist, und die Iteration erfolgt in Einfügereihenfolge.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Map()
new Map(iterable)
map.set(key, value)
map.get(key)
map.has(key)
map.delete(key)
map.clear()
map.size
for (const [key, value] of map) { /* ... */ }Map ist eine eingebaute Sammlung von Schlüssel-Wert-Paaren. Sowohl Schlüssel als auch Werte können beliebige JavaScript-Werte sein. Erstelle eine leere Map mit new Map() oder übergib dem Konstruktor ein iterierbares Objekt mit [key, value]-Paaren. Ein Aufruf ohne new löst einen TypeError aus.
set(key, value) fügt einen Eintrag hinzu oder aktualisiert ihn und gibt die Map zurück. get(key) liest den Wert aus; bei einem fehlenden Schlüssel wird undefined zurückgegeben. Da auch ein gespeicherter Wert undefined sein kann, prüfe das Vorhandensein mit has(key). Die Eigenschaft size gibt die Anzahl der Einträge an, delete(key) meldet zurück, ob ein Eintrag gelöscht wurde, und clear() entfernt alle Einträge.
Der Schlüsselvergleich folgt SameValueZero: NaN stimmt mit NaN überein, und +0 und -0 gelten als derselbe Schlüssel. Objekte werden anhand ihrer Identität verglichen, nicht anhand ihres Inhalts. Zwei getrennt erstellte Objekte { id: 1 } sind daher unterschiedliche Schlüssel.
Die Iteration mit for...of liefert Paare in der Einfügereihenfolge der Schlüssel; keys(), values() und entries() geben die entsprechenden Iteratoren zurück. Eine Aktualisierung des Werts ändert die Position des Eintrags nicht; Löschen und erneutes Einfügen verschiebt ihn jedoch ans Ende. Verwende zum Hinzufügen von Einträgen set(key, value), nicht map[key] = value. Eine Zuweisung mit eckigen Klammern bezieht sich auf eine Objekteigenschaft, nicht auf einen Map-Eintrag. Bei einer unveränderten Map-Instanz löst map["size"] = value beispielsweise im strikten Modus einen TypeError aus und wird sonst ignoriert, weil die geerbte Eigenschaft size einen Getter, aber keinen Setter hat.
Beispiele
const key = { id: 1 };
const map = new Map([["first", 1], [key, 2]]);
map.set("first", 3);
map.set(NaN, 4);
map.set(NaN, 5);
console.log(map.size);
console.log(map.get(key));
console.log(map.has({ id: 1 }));
console.log(map.get(NaN));
console.log(JSON.stringify([...map.values()]));Ergebnis
3 2 false 5 [3,2,5]
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.