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

CKTIS / JavaScript

WeakSet — množina so slabými referenciami

WeakSet obsahuje jedinečné objekty a neregistrované symboly bez toho, aby ich udržiavala nažive iba vďaka členstvu v množine. Ponúka add, has a delete, ale neumožňuje iterovať cez prvky ani zistiť ich počet.

Verzia: WeakSet was introduced in ECMAScript 2015 (ES2015). Support for non-registered symbols as elements was added in ECMAScript 2023 (ES2023).

Syntax

new WeakSet()
new WeakSet(iterable)
weakSet.add(value)
weakSet.has(value)
weakSet.delete(value)

WeakSet slúži na sledovanie hodnôt, napríklad už spracovaných objektov. Objekty sa rozlišujú podľa identity, nie obsahu: dva samostatné objekty { id: 1 } sú rôzne prvky. new WeakSet(iterable) pridá hodnoty z odovzdaného iterovateľného objektu; konštruktor vyžaduje new.

WeakSet.prototype.add(value) pridá prvok, ignoruje duplicity a vráti tú istú množinu, takže volania možno reťaziť. WeakSet.prototype.has(value) vráti informáciu o členstve ako boolean. WeakSet.prototype.delete(value) vráti true, ak odstráni existujúci prvok, inak vráti false.

Povolené sú objekty vrátane funkcií a symboly nezaregistrované pomocou Symbol.for. Pri nepodporovaných hodnotách, ako sú čísla, reťazce, null alebo výsledok Symbol.for, vyvolá add chybu TypeError, zatiaľ čo has a delete vrátia false. Podpora symbolov bola pridaná v ECMAScript 2023; staršie enginy môžu prijímať iba objekty. Špecifikácia jazyka nie je tabuľkou kompatibility prehliadačov: overte podporu tejto funkcie v cieľovom prostredí.

Na rozdiel od Set neudržiava WeakSet prvky nažive iba vďaka ich členstvu. Čas uvoľnenia pamäte nie je zaručený. Nie sú k dispozícii size, iterácia, forEach ani clear; na kontrolu členstva musíte mať príslušnú hodnotu. Vyberte Set, ak potrebujete vypísať prvky alebo poznať ich počet.

Príklady

const first = { id: 1 };
const second = { id: 1 };
const seen = new WeakSet([first]);

console.log(seen.has(first));
console.log(seen.has(second));
console.log(seen.add(second) === seen);
console.log(seen.has(second));
console.log(seen.delete(first));
console.log(seen.delete(first));
console.log(seen.has(first));

Výsledok

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