Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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