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

CKTIS / JavaScript

WeakMap.prototype.set(): uložení hodnoty pod klíčem

Metoda `set()` přidá do `WeakMap` novou položku nebo nahradí hodnotu u existujícího klíče. Vrací stejnou instanci, takže lze volání řetězit.

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

Syntaxe

weakMap.set(key, value)

WeakMap.prototype.set je metoda prototypu, která se volá na instanci: weakMap.set(key, value). Přidá položku pro nový klíč nebo nahradí hodnotu u stejného klíče. Vrací stejnou instanci, nikoli uloženou hodnotu, takže lze přímo navázat dalším voláním .set(). Hodnotou může být libovolná hodnota JavaScriptu včetně undefined.

Objektové klíče se porovnávají podle identity: dva různé objekty se stejnými vlastnostmi jsou různé klíče. ECMAScript 2024 připouští i neregistrované symboly jako Symbol("id"). Symboly získané pomocí Symbol.for("id") ani jiné primitivní hodnoty, například řetězce, nejsou platnými klíči. Starší běhová prostředí nemusí symboly jako klíče podporovat; ověřte si cílové prostředí.

Neplatný klíč vyvolá chybu TypeError. Stejnou chybu vyvolá volání samostatně předané metody bez správného this: příjemcem volání musí být instance WeakMap.

Samotná položka neudržuje klíč při životě. Pokud už klíč není dosažitelný jinou cestou, může jej správce paměti odstranit; nespoléhejte na to, kdy k tomu dojde. Klíče WeakMap nelze vyjmenovat. Pokud potřebujete klíče procházet nebo používat řetězce jako klíče, zvolte místo toho Map.

Příklady

{
  const metadata = new WeakMap();
  const item = { id: 1 };

  metadata.set(item, 10);
  console.log(metadata.get(item));

  const returned = metadata.set(item, 20);
  console.log(returned === metadata);
  console.log(metadata.get(item));
  console.log(metadata.has({ id: 1 }));

  try {
    metadata.set("id", 30);
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Výsledek

10
true
20
false
true

První čtení vrátí `10`, čtení po aktualizaci vrátí `20`. Výsledkem porovnání `returned === metadata` je `true`. Nový objekt se stejným `id` není uloženým klíčem, takže `has()` vrátí `false`. Pokus použít řetězec jako klíč vyvolá chybu `TypeError`, která se zachytí.

Související lekce

  • JavaScript · Lekce 35 · Základní · Verze: 4
  • JavaScript · Lekce 37 · Základní · Verze: 4
  • JavaScript · Lekce 4 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 10 · Středně pokročilá · Verze: 3

Zdroje