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

CKTIS / JavaScript

WeakMap.set(): přidání nebo nahrazení hodnoty

Metoda `set()` uloží hodnotu pod klíčem v kolekci `WeakMap`. Pokud klíč už existuje, jeho hodnotu nahradí. Vrací tutéž kolekci, takže lze volání řetězit.

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

Syntaxe

weakMap.set(key, value)

WeakMap.set označuje metodu instance WeakMap.prototype.set, nikoli statickou metodu konstruktoru WeakMap. weakMap.set(key, value) přidá položku pro nový klíč nebo nahradí hodnotu existujícího klíče. Vrátí tutéž kolekci WeakMap, takže lze hned připojit další volání .set(). Hodnota může být libovolná; při vynechání value se uloží undefined.

Objektové klíče se porovnávají podle identity: dva samostatně vytvořené objekty {} jsou různé klíče. ECMAScript 2024 povoluje také neregistrované symboly, například Symbol(). Starší běhová prostředí mohou jako klíče podporovat pouze objekty. Použití řetězce, čísla, null nebo symbolu registrovaného přes Symbol.for() jako klíče vyvolá TypeError. Stejná výjimka nastane, pokud this při volání není instancí WeakMap.

Samotná položka neudržuje klíč při životě. Jakmile klíč přestane být dosažitelný mimo tuto slabou vazbu, správce paměti jej může uvolnit, ale není zaručeno kdy. To se hodí pro ukládání doplňujících údajů o objektu, aniž by se prodloužila jeho životnost. Pokud potřebuješ řetězcové klíče nebo procházet položky, použij Map.

Příklady

{
  const statuses = new WeakMap();
  const task = {};
  const otherTask = {};

  const result = statuses.set(task, "pending").set(otherTask, false);
  statuses.set(task, "ready");

  console.log(result === statuses);
  console.log(statuses.get(task));
  console.log(statuses.get(otherTask));
  console.log(statuses.has({}));

  try {
    statuses.set("task", "ready");
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Výsledek

true
ready
false
false
true

První `true` ukazuje, že řetězená volání vracejí tutéž kolekci. `ready` nahrazuje `pending`. První `false` je uložená hodnota pro `otherTask`; druhé znamená, že nový objekt `{}` není klíčem v kolekci. Poslední `true` potvrzuje, že řetězcový klíč vyvolal `TypeError`.

Související lekce

  • JavaScript · Lekce 18 · Základní · Verze: 4

Zdroje