Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

WeakMap — metapodatki s šibko zadržanimi ključi

WeakMap povezuje vrednosti s ključi, ne da bi same ključe ohranjal pri življenju. Spoznajte metode set, get, has in delete, primerjavo ključev po identiteti ter omejitve glede iteracije in zbiranja smeti.

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

Sintaksa

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

WeakMap shranjuje povezave ključ–vrednost. Ključi so lahko objekti ali simboli zunaj globalnega registra simbolov, na primer Symbol(), ne pa Symbol.for(). Podpora za te simbole je del ECMAScript 2023; starejši pogoni lahko sprejemajo samo objekte. Vrednosti so lahko poljubne vrednosti JavaScripta. Objekti se primerjajo po identiteti: dva ločena objekta {} sta različna ključa.

WeakMap.set tu pomeni instančno metodo WeakMap.prototype.set, ne statične metode. wm.set(key, value) doda ali zamenja vrednost in vrne wm. Podobno WeakMap.get pomeni WeakMap.prototype.get: wm.get(key) vrne vrednost ali undefined. WeakMap.prototype.has, klicana kot wm.has(key), razlikuje med manjkajočim zapisom in zapisom z vrednostjo undefined.

WeakMap.delete pomeni WeakMap.prototype.delete: wm.delete(key) odstrani zapis in vrne true, če je obstajal, sicer pa false. Neveljavna vrsta ključa pri set povzroči napako TypeError; za ta ključ get vrne undefined, has in delete pa vrneta false.

Šibka povezava ne prepreči zbiranja ključa, ki sicer ni več dosegljiv. Čas zbiranja ni zagotovljen; od njega ne delajte odvisne pravilnosti programa. WeakMap ne omogoča iteriranja po zapisih in nima size. Uporabite ga za metapodatke, povezane z objekti; če morate zapise našteti, izberite Map.

Primeri

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));

Rezultat

true
7
false
true
true
true
false

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri