Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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