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

CKTIS / JavaScript

WeakMap.get() — načtení hodnoty podle klíče

`weakMap.get(key)` vrací hodnotu přiřazenou ke klíči. Pomocí `has(key)` rozlišíš chybějící záznam od záznamu s hodnotou `undefined`.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

weakMap.get(key)

WeakMap.get je zkrácené označení metody instance WeakMap.prototype.get, nikoli statické metody konstruktoru. weakMap.get(key) načte uloženou hodnotu, aniž by mapu změnilo. Klíče se porovnávají podle identity: dva samostatně vytvořené objekty se stejnými vlastnostmi jsou různé klíče. Pokud je uložená hodnota objekt, get() vrátí tentýž objekt, nikoli kopii.

Chybějící záznam i záznam s hodnotou undefined dávají stejný výsledek: undefined. Rozlišíš je pomocí weakMap.has(key), která vrací true, když záznam existuje, i kdyby jeho hodnota byla undefined.

ECMAScript 2024 povoluje jako klíče objekty včetně funkcí a neregistrované symboly jako Symbol('id'). Starší enginy mohou podporovat WeakMap, ale ne symboly jako klíče. Na instanci WeakMap vrací get() pro neplatný klíč, například řetězec nebo symbol vrácený z Symbol.for(), hodnotu undefined, zatímco set() vyvolá TypeError. Samotná metoda get() vyvolá TypeError, pokud její this není instance WeakMap, například když ji zavoláš samostatně bez vazby na instanci.

Mapa sama nebrání uvolnění klíče z paměti. Jakmile klíč přestane být dosažitelný, může být jeho záznam odstraněn při automatickém uvolňování paměti. Klíče nelze vypsat ani se spoléhat na odstranění záznamu v určitou chvíli.

Příklady

const weakMap = new WeakMap();
const key = { id: 1 };
const otherKey = { id: 1 };

weakMap.set(key, 42);
console.log(String(weakMap.get(key)));
console.log(String(weakMap.get(otherKey)));

weakMap.set(otherKey, undefined);
console.log(String(weakMap.get(otherKey)));
console.log(String(weakMap.has(otherKey)));
console.log(String(weakMap.get('id')));

Výsledek

42
undefined
undefined
true
undefined

`key` a `otherKey` jsou různé objekty, i když mají stejné vlastnosti. Obě čtení s klíčem `otherKey` vrátí `undefined`: nejprve záznam chybí, potom existuje s hodnotou `undefined`, což potvrdí `has()`. Poslední čtení používá neplatný klíč.

Související lekce

  • JavaScript · Lekce 18 · Základní · Verze: 4

Zdroje