Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Map.prototype.get: čtení hodnoty podle klíče

Metoda get vrátí hodnotu uloženou pod odpovídajícím klíčem Map, nebo undefined, pokud položka neexistuje.

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

Syntaxe

map.get(key)

map.get(key) hledá klíč bez převodu typu a nemění Map ani pořadí. Pro nalezený klíč vrátí přesnou uloženou hodnotu včetně stejného odkazu na objekt; pro chybějící klíč undefined.

Klíče používají SameValueZero: NaN odpovídá NaN a -0 odpovídá +0; objekty jen identitou odkazu. Existující položka může záměrně obsahovat undefined, takže get ji od absence nerozliší—použijte map.has(key).

Příjemce musí mít interní data Map; objekt, Set nebo neošetřený Proxy jako this vyvolá TypeError. Standardní od ECMAScript 2015. get nespouští továrnu ani nevytváří položku; get-or-create musí výslovně použít has/set a zohlednit undefined.

Příklady

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);
}

Výsledek

true
undefined
not a number
undefined true
undefined false
true

Zdroje