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

CKTIS / JavaScript

WeakSet: ověřování členství a přidávání prvků pomocí has() a add()

Pomocí `has()` ověříš, zda hodnota patří do `WeakSet`, a pomocí `add()` ji přidáš. O členství rozhoduje identita hodnoty a kolekce ji sama neudržuje při životě.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const seen = new WeakSet();
seen.has(value);
seen.add(value);

WeakSet.prototype.has a WeakSet.prototype.add jsou dvě metody instance. seen.has(value) vrátí true, pokud je hodnota v kolekci, jinak false. seen.add(value) vloží hodnotu, pokud tam ještě není, a vrátí tutéž instanci WeakSet. Opakované přidání nevytvoří duplikát a návratová hodnota umožňuje řetězit volání add().

Při ověřování členství se porovnává identita, nikoli obsah: dva odkazy na tentýž objekt označují stejný prvek, ale dva různé objekty se shodnými vlastnostmi se neshodují. ECMAScript 2024 přijímá objekty (včetně funkcí) a neregistrované symboly, například ty vytvořené pomocí Symbol(). Pro symbol z Symbol.for(), číslo, řetězec nebo null vrátí has() hodnotu false, zatímco add() vyvolá TypeError. Obě metody vyvolají TypeError také tehdy, když this není instance WeakSet, například při samostatném volání uložené metody bez vazby na instanci.

Samotné členství nezabrání tomu, aby správce paměti hodnotu uvolnil. Kdy k tomu dojde, nelze předpovědět. WeakSet nemá vlastnost size a nelze přes něj iterovat. Hodí se k označení již zpracovaných objektů, pokud je později nepotřebuješ vypsat. Zvol Set, pokud potřebuješ iteraci, velikost kolekce nebo prvky jako čísla a řetězce.

Podpora symbolů se může lišit podle běhového prostředí. Pokud ji potřebuješ, vyzkoušej add() s hodnotou vytvořenou pomocí Symbol() v cílovém prostředí; ověřit jen existenci WeakSet nestačí.

Příklady

{
  const seen = new WeakSet();
  const item = { id: 1 };
  const alias = item;

  console.log(seen.has(item));
  console.log(seen.add(item).add(item) === seen);
  console.log(seen.has(alias));
  console.log(seen.has({ id: 1 }));
  console.log(seen.has(1));

  try {
    seen.add(1);
  } catch (error) {
    console.log(error.name);
  }
}

Výsledek

false
true
true
false
false
TypeError

První volání `has()` vrátí `false`. Dvě volání `add()` lze zřetězit, protože metoda vrací tutéž instanci. `alias` odkazuje na vložený objekt, ale nový objekt se stejným `id` se s ním neshoduje. Pro číslo `1` vrátí kontrola `false` a vložení vyvolá zachycený `TypeError`.

Související lekce

  • JavaScript · Lekce 17 · Pokročilá · Verze: 4
  • JavaScript · Lekce 43 · Pokročilá · Verze: 4
  • JavaScript · Lekce 45 · Pokročilá · Verze: 4
  • JavaScript · Lekce 40 · Středně pokročilá · Verze: 3

Zdroje