CKTIS / JavaScript
WeakMap.prototype.get() — načtení hodnoty podle klíče
Pomocí `weakMap.get(key)` načteš uloženou hodnotu beze změny mapy. Metoda `has()` rozliší chybějící položku od položky s uloženou hodnotou `undefined`.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
weakMap.get(key)WeakMap.prototype.get je metoda instance, kterou voláš jako weakMap.get(key). Vrátí hodnotu přiřazenou ke klíči, aniž by přidala nebo změnila položku. Pokud je uloženou hodnotou objekt, vrátí tentýž objekt, ne jeho kopii.
Klíče se porovnávají podle identity: dva samostatné objekty se stejnými vlastnostmi jsou různé klíče. ECMAScript 2024 připouští jako klíče objekty a neregistrované symboly, například symboly vytvořené pomocí Symbol(), nikoli však symboly získané pomocí Symbol.for(). Starší běhová prostředí nemusí symboly jako klíče podporovat.
get() vrací undefined, pokud položka chybí, klíč je neplatný (například řetězec) nebo je uloženou hodnotou undefined. Pomocí weakMap.has(key) rozlišíš uložené undefined (true) od chybějící položky (false). Na rozdíl od get() vyvolá set() pro neplatný klíč výjimku TypeError. Samotné get() vyvolá TypeError, pokud this není instancí WeakMap, například když metodu uložíš do proměnné a zavoláš ji bez navázání na mapu.
WeakMap neudržuje klíč při životě jen tím, že ho ukládá. Její klíče nelze vypsat a nelze předpovědět, kdy automatická správa paměti uvolní nedosažitelný klíč.
Příklady
{
const weakMap = new WeakMap();
const key = { id: 1 };
const lookalike = { id: 1 };
const pending = {};
weakMap.set(key, 42);
weakMap.set(pending, undefined);
console.log(weakMap.get(key));
console.log(weakMap.get(lookalike));
console.log(weakMap.get(pending));
console.log(weakMap.has(pending));
console.log(weakMap.has(lookalike));
console.log(weakMap.get("id"));
}Výsledek
42 undefined undefined true false undefined
`lookalike` má stejné vlastnosti jako `key`, ale je to jiný objekt. Pro `lookalike` i `pending` vrací `get()` hodnotu `undefined`, ale `has()` vrací `true` jen pro `pending`. Vyhledání pomocí řetězce `"id"` vrátí `undefined` bez výjimky.
Související lekce
- JavaScript · Lekce 35 · Základní · Verze: 4
- JavaScript · Lekce 37 · Základní · Verze: 4
- JavaScript · Lekce 4 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 10 · Středně pokročilá · Verze: 3