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
- ECMAScript® Language Specification
- ECMAScript® Language Specification — Keyed Collections
- ECMAScript® 2023 Language Specification — Keyed Collections
- ECMAScript® 2026 Language Specification — Executable Code and Execution Contexts
- Official reference — developer.mozilla.org: WeakSet / has
- Official reference — developer.mozilla.org: WeakSet / add
- Official reference — tc39.es: ecma262