CKTIS / JavaScript
WeakMap — metapodaci sa slabo zadržanim ključevima
WeakMap povezuje vrijednosti s ključevima, a da same ključeve ne održava na životu. Saznajte o metodama set, get, has i delete, usporedbi ključeva prema identitetu te ograničenjima iteracije i skupljanja smeća.
Verzija: 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 pohranjuje veze ključ–vrijednost. Ključevi mogu biti objekti ili simboli izvan globalnog registra simbola, primjerice Symbol(), ali ne i Symbol.for(). Podrška za te simbole dio je ECMAScripta 2023; stariji pogoni možda prihvaćaju samo objekte. Vrijednosti mogu biti bilo koje JavaScript vrijednosti. Objekti se uspoređuju prema identitetu: dva zasebna objekta {} različiti su ključevi.
WeakMap.set ovdje označava instancnu metodu WeakMap.prototype.set, a ne statičku metodu. wm.set(key, value) dodaje ili zamjenjuje vrijednost i vraća wm. Isto tako, WeakMap.get označava WeakMap.prototype.get: wm.get(key) vraća vrijednost ili undefined. WeakMap.prototype.has, pozvana kao wm.has(key), razlikuje nedostajući zapis od zapisa čija je vrijednost undefined.
WeakMap.delete označava WeakMap.prototype.delete: wm.delete(key) uklanja zapis i vraća true ako je postojao, a u suprotnom false. Nevažeći tip ključa uzrokuje TypeError pri pozivu set; za taj ključ get vraća undefined, dok has i delete vraćaju false.
Slaba veza ne sprječava prikupljanje ključa koji inače više nije dohvatljiv. Vrijeme prikupljanja nije zajamčeno; nemojte o njemu činiti ovisnom ispravnost programa. WeakMap ne omogućuje iteriranje po zapisima niti ima size. Koristite ga za metapodatke povezane s objektima; odaberite Map ako trebate nabrajati zapise.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.
Izvori
- 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