CKTIS / JavaScript
WeakSet — množina se slabými referencemi
WeakSet obsahuje jedinečné objekty a neregistrované symboly, aniž by je udržovala naživu pouze díky jejich členství v množině. Nabízí add, has a delete, ale neumožňuje iterovat přes prvky ani zjistit jejich počet.
Verze: WeakSet was introduced in ECMAScript 2015 (ES2015). Support for non-registered symbols as elements was added in ECMAScript 2023 (ES2023).
Syntaxe
new WeakSet()
new WeakSet(iterable)
weakSet.add(value)
weakSet.has(value)
weakSet.delete(value)WeakSet slouží ke sledování hodnot, například již zpracovaných objektů. Objekty se rozlišují podle identity, nikoli obsahu: dva samostatné objekty { id: 1 } jsou různé prvky. new WeakSet(iterable) přidá hodnoty z předaného iterovatelného objektu; konstruktor vyžaduje new.
WeakSet.prototype.add(value) přidá prvek, ignoruje duplicity a vrátí stejnou množinu, takže lze volání řetězit. WeakSet.prototype.has(value) vrací informaci o členství jako boolean. WeakSet.prototype.delete(value) vrátí true, pokud odstraní existující prvek, jinak vrátí false.
Povolené jsou objekty včetně funkcí a symboly nezaregistrované pomocí Symbol.for. U nepodporovaných hodnot, jako jsou čísla, řetězce, null nebo výsledek Symbol.for, vyvolá add chybu TypeError, zatímco has a delete vrátí false. Podpora symbolů byla přidána v ECMAScript 2023; starší enginy mohou přijímat pouze objekty. Specifikace jazyka není tabulkou kompatibility prohlížečů: ověřte podporu této funkce v cílovém prostředí.
Na rozdíl od Set neudržuje WeakSet prvky naživu pouze díky jejich členství. Okamžik uvolnění paměti není zaručen. Nejsou k dispozici size, iterace, forEach ani clear; ke kontrole členství je nutné mít příslušnou hodnotu. Zvolte Set, pokud potřebujete prvky vypsat nebo znát jejich počet.
Pří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ýsledek
true false true true true false false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.
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