WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Map.prototype.get: Wert nach Schlüssel lesen

Die Methode get liefert den unter einem passenden Map-Schlüssel gespeicherten Wert oder undefined, wenn kein Eintrag existiert.

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

Syntax

map.get(key)

map.get(key) sucht ohne Typumwandlung und verändert weder Map noch Eintragsreihenfolge. Bei gefundenem Schlüssel liefert es genau den gespeicherten Wert einschließlich derselben Objektreferenz, bei fehlendem Schlüssel undefined.

Schlüssel verwenden SameValueZero: NaN passt zu NaN und -0 zu +0; Objekte passen nur über Referenzidentität. Da ein vorhandener Eintrag absichtlich undefined enthalten kann, unterscheidet get allein dies nicht vom Fehlen—verwenden Sie dafür map.has(key).

Der Empfänger muss interne Map-Daten besitzen; gewöhnliches Objekt, Set oder unbehandelter Proxy als this löst TypeError aus. Seit ECMAScript 2015 Standard. get ruft keine Wertfabrik auf und erzeugt keinen Eintrag; Get-or-create muss has/set explizit und undefined korrekt behandeln.

Beispiele

const key = { id: 7 };
const stored = { enabled: true };
const map = new Map([[key, stored], ["empty", undefined], [NaN, "not a number"]]);
console.log(map.get(key) === stored);
console.log(map.get({ id: 7 }));
console.log(map.get(NaN));
console.log(map.get("empty"), map.has("empty"));
console.log(map.get("missing"), map.has("missing"));

try {
  Map.prototype.get.call({}, "x");
} catch (error) {
  console.log(error instanceof TypeError);
}

Ergebnis

true
undefined
not a number
undefined true
undefined false
true

Quellen