CKTIS / JavaScript
WeakMap — metadáta so slabo držanými kľúčmi
WeakMap priraďuje hodnoty ku kľúčom bez toho, aby samotné kľúče udržiavala pri živote. Spoznajte metódy set, get, has a delete, porovnávanie kľúčov podľa identity a obmedzenia iterácie a garbage collectora.
Verzia: ECMAScript 2015 (ES2015) introduced WeakMap. ECMAScript 2023 (ES2023) added support for non-registered symbols as keys.
Syntax
const wm = new WeakMap();
wm.set(key, value);
wm.get(key);
wm.has(key);
wm.delete(key);WeakMap ukladá dvojice kľúč–hodnota. Kľúčmi môžu byť objekty alebo symboly mimo globálneho registra symbolov, napríklad Symbol(), nie však Symbol.for(). Podpora týchto symbolov je súčasťou ECMAScriptu 2023; staršie enginy môžu prijímať iba objekty. Hodnotami môžu byť ľubovoľné hodnoty JavaScriptu. Objekty sa porovnávajú podľa identity: dva samostatné objekty {} sú rôzne kľúče.
WeakMap.set tu označuje inštančnú metódu WeakMap.prototype.set, nie statickú metódu. wm.set(key, value) pridá alebo nahradí hodnotu a vráti wm. Podobne WeakMap.get označuje WeakMap.prototype.get: wm.get(key) vráti hodnotu alebo undefined. WeakMap.prototype.has, volaná ako wm.has(key), rozlišuje chýbajúci záznam od záznamu s hodnotou undefined.
WeakMap.delete označuje WeakMap.prototype.delete: wm.delete(key) odstráni záznam a vráti true, ak existoval, inak false. Neplatný typ kľúča spôsobí pri použití set chybu TypeError; pre tento kľúč vráti get hodnotu undefined a metódy has a delete vrátia false.
Slabá väzba nezabráni uvoľneniu kľúča, ktorý už nie je dosiahnuteľný iným spôsobom. Čas uvoľnenia nie je zaručený; nezakladajte na ňom správnosť programu. WeakMap neumožňuje iteráciu cez záznamy ani neposkytuje size. Použite ho na metadáta spojené s objektmi; ak potrebujete záznamy vymenovať, vyberte Map.
Prí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ýsledok
true 7 false true true true false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.
Zdroje
- ECMAScript® Language Specification
- ECMAScript® Language Specification — Keyed Collections
- ECMAScript® 2023 Language Specification — Executable Code and Execution Contexts
- Official reference — tc39.es: ecma262
- Official reference — tc39.es: ecma262
- Official reference — tc39.es: ecma262
- Official reference — developer.mozilla.org: WeakMap / has