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

CKTIS / JavaScript

WeakMap — metadata se slabě drženými klíči

WeakMap přiřazuje hodnoty ke klíčům, aniž by samotné klíče udržovala při životě. Seznamte se s metodami set, get, has a delete, porovnáváním klíčů podle identity a omezeními iterace a garbage collectoru.

Verze: ECMAScript 2015 (ES2015) introduced WeakMap. ECMAScript 2023 (ES2023) added support for non-registered symbols as keys.

Syntaxe

const wm = new WeakMap();
wm.set(key, value);
wm.get(key);
wm.has(key);
wm.delete(key);

WeakMap ukládá dvojice klíč–hodnota. Klíči mohou být objekty nebo symboly mimo globální registr symbolů, například Symbol(), nikoli však Symbol.for(). Podpora těchto symbolů je součástí ECMAScriptu 2023; starší enginy mohou přijímat pouze objekty. Hodnotami mohou být libovolné hodnoty JavaScriptu. Objekty se porovnávají podle identity: dva samostatné objekty {} jsou různé klíče.

WeakMap.set zde označuje instanční metodu WeakMap.prototype.set, nikoli statickou metodu. wm.set(key, value) přidá nebo nahradí hodnotu a vrátí wm. Podobně WeakMap.get označuje WeakMap.prototype.get: wm.get(key) vrátí hodnotu nebo undefined. WeakMap.prototype.has, volaná jako wm.has(key), rozlišuje chybějící záznam od záznamu s hodnotou undefined.

WeakMap.delete označuje WeakMap.prototype.delete: wm.delete(key) odstraní záznam a vrátí true, pokud existoval, jinak false. Neplatný typ klíče způsobí při použití set chybu TypeError; pro tento klíč vrátí get hodnotu undefined a metody has a delete vrátí false.

Slabá vazba nezabrání uvolnění klíče, který již není dosažitelný jiným způsobem. Okamžik uvolnění není zaručen; nezakládejte na něm správnost programu. WeakMap neumožňuje iteraci přes záznamy ani nenabízí size. Použijte jej pro metadata spojená s objekty; pokud potřebujete záznamy vyjmenovat, zvolte Map.

Příklady

const metadata = new WeakMap();
const key = {};
const other = {};

console.log(metadata.set(key, 7) === metadata);
console.log(metadata.get(key));
console.log(metadata.has(other));
metadata.set(key, undefined);
console.log(metadata.has(key));
console.log(metadata.get(key) === undefined);
console.log(metadata.delete(key));
console.log(metadata.delete(key));

Výsledek

true
7
false
true
true
true
false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje