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