Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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