WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Map.prototype.set: Eintrag schreiben

Die Methode set fügt ein Schlüssel-Wert-Paar hinzu oder aktualisiert es und liefert dieselbe Map zum Verketten.

Version: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

map.set(key, value)

map.set(key, value) speichert ohne Umwandlung und liefert die empfangende Map. Ein neuer Schlüssel kommt ans Ende der Einfügereihenfolge. Die Aktualisierung ersetzt den Wert, ohne size oder Position zu ändern; erst delete gefolgt von set erzeugt eine neue Position am Ende.

Schlüssel verwenden SameValueZero: NaN passt zu NaN, -0 wird zu +0 normalisiert. Objekt-Schlüssel und -Werte bleiben dieselben Referenzen und werden nicht geklont. Die Rückgabe erlaubt map.set(a, 1).set(b, 2).

Der Empfänger muss interne Map-Daten besitzen; Objekt, Set oder unbehandelter Proxy löst TypeError aus. Seit ECMAScript 2015 Standard. Bei Get-or-create kann ein vorhandener Wert undefined sein, daher prüft get allein nicht immer die Anwesenheit.

Beispiele

const map = new Map();
console.log(map.set("a", 1) === map);
map.set("b", 2).set("a", 3);
console.log(map.size, [...map.keys()].join(","), map.get("a"));
map.delete("a");
map.set("a", 4);
console.log([...map.keys()].join(","));
const key = {};
const value = {};
map.set(key, value);
console.log(map.get(key) === value);
map.set(NaN, 1).set(NaN, 2).set(-0, "zero");
console.log(map.get(NaN), map.get(+0));
try { Map.prototype.set.call({}, "x", 1); } catch (error) { console.log(error instanceof TypeError); }

Ergebnis

true
2 a,b 3
b,a
true
2 zero
true

Quellen