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

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) // boolean

WeakSet.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

Zdroje