CKTIS / JavaScript
WeakSet: ověření členství, přidávání a odebírání prvků
Metoda `has()` ověří, zda hodnota patří do množiny, `add()` ji přidá a `delete()` ji odebere. Metody se liší návratovou hodnotou i tím, jak reagují na nepovolený vstup.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
weakSet.has(value) // boolean
weakSet.add(value) // the same WeakSet instance
weakSet.delete(value) // booleanWeakSet.prototype.has/add/delete je zkratka pro tři metody na WeakSet.prototype, nikoli název jedné metody. Volej je na instanci, například seen.has(value). Volání bez instance WeakSet jako this vyvolá TypeError. To platí i tehdy, když metodu oddělíš od instance a zavoláš ji jako obyčejnou funkci.
has(value) vrátí true, když je hodnota v množině, jinak vrátí false. Množinu nemění. add(value) přidá hodnotu jen tehdy, když v množině ještě není, a při úspěchu vrátí stejnou instanci, takže můžeš volání řetězit. delete(value) vrátí true, pouze pokud prvek odebrala; jinak vrátí false. O členství rozhoduje identita, ne obsah: dva samostatně vytvořené objekty { id: 1 } jsou různé prvky.
ECMAScript 2024 připouští objekty (včetně funkcí) a neregistrované symboly, například Symbol(). Symboly z globálního registru vracené funkcí Symbol.for() ani jiné primitivní hodnoty jako 1 a null nejsou povolené. Pro nepovolenou hodnotu add() vyvolá TypeError, zatímco has() a delete() vrátí false. Starší běhová prostředí mohou přijímat jen objekty; ověř si podporu symbolů v cílovém prostředí.
Položka ve WeakSet sama o sobě neudržuje hodnotu při životě. Pokud už hodnota není dosažitelná přes silné reference, může ji správce paměti uvolnit; nespoléhej na to, kdy k tomu dojde. WeakSet není iterovatelný a nemá vlastnost size. Hodí se k označování zpracovaných objektů. Pokud potřebuješ prvky procházet nebo počítat, použij Set, který si na ně uchovává silné reference.
Příklady
{
const seen = new WeakSet();
const task = { id: 1 };
const lookalike = { id: 1 };
console.log(seen.add(task).add(task) === seen);
console.log(seen.has(task));
console.log(seen.has(lookalike));
console.log(seen.delete(task));
console.log(seen.delete(task));
console.log(seen.has(task));
console.log(seen.has(1));
console.log(seen.delete(1));
try {
seen.add(1);
} catch (error) {
console.log(error instanceof TypeError);
}
}Výsledek
true true false true false false false false true
I po dvojím přidání objektu `task` se vrátí `seen`. Objekt `lookalike` má stejný obsah, ale do množiny nepatří. Pouze první odebrání `task` vrátí `true`. Poslední `true` potvrzuje typ chyby při volání `add(1)`; výstup nezávisí na automatickém uvolňování paměti.
Související lekce
- JavaScript · Lekce 30 · Středně pokročilá · Verze: 3