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

CKTIS / JavaScript

WeakMap: ověřování, čtení a zápis položek pomocí has(), get() a set()

Zjisti, zda klíč existuje, přečti jeho hodnotu nebo ji změň. Nauč se rozlišit chybějící položku od uloženého `undefined` a poznat, které klíče `WeakMap` přijímá.

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

Syntaxe

weakMap.has(key)
weakMap.get(key)
weakMap.set(key, value)

WeakMap.prototype.has/get/set je zkratka pro tři metody instance WeakMap. Klíče se porovnávají podle identity: dva samostatné objekty se stejnými vlastnostmi jsou různé klíče.

  • has(key) vrátí true, pokud položka existuje, jinak false.
  • get(key) vrátí uloženou hodnotu, nebo undefined, pokud položka neexistuje. Pomocí has(key) rozlišíš chybějící položku od uloženého undefined.
  • set(key, value) přidá položku nebo nahradí hodnotu pod stejným klíčem. Přijímá libovolnou hodnotu JavaScriptu a vrací stejnou instanci WeakMap, takže volání lze řetězit.

ECMAScript 2024 povoluje jako klíče objekty (včetně funkcí) a neregistrované symboly, například Symbol() a Symbol.iterator, nikoli však symboly získané pomocí Symbol.for(). Starší běhová prostředí mohou přijímat jen objektové klíče; ověř podporu symbolů jako klíčů v cílovém prostředí.

Pro neplatný klíč, například 1, vrátí has() hodnotu false, get() vrátí undefined a set() vyvolá výjimku TypeError. Všechny tři metody nejprve kontrolují this: pokud nejde o skutečnou instanci WeakMap, volání vyvolá výjimku TypeError bez ohledu na klíč.

WeakMap umožňuje přiřadit k objektu metadata, aniž by udržovala klíč při životě, a to i tehdy, když uložená hodnota na klíč odkazuje. Okamžik uvolnění paměti není zaručen. WeakMap neumožňuje procházet klíče ani nemá size; použij Map, pokud tyto možnosti potřebuješ nebo chceš používat řetězce či čísla jako klíče.

Příklady

{
  const map = new WeakMap();
  const key = { id: 1 };
  const lookalike = { id: 1 };

  map.set(key, undefined);
  console.log(`stored: ${map.has(key)}, ${map.get(key)}`);
  console.log(`missing: ${map.has(lookalike)}, ${map.get(lookalike)}`);

  const result = map.set(key, 42);
  console.log(`updated: ${map.get(key)}, same map: ${result === map}`);

  console.log(`invalid key: ${map.has(1)}, ${map.get(1)}`);
  try {
    map.set(1, 42);
  } catch (error) {
    console.log(error.name);
  }
}

Výsledek

stored: true, undefined
missing: false, undefined
updated: 42, same map: true
invalid key: false, undefined
TypeError

`key` a `lookalike` mají stejné `id`, ale jsou to různé objekty. Obě čtení nejprve vrátí `undefined`; pouze `has(key)` vrátí `true`. Druhý zápis nahradí hodnotu číslem `42` a vrátí stejnou mapu. Klíč `1` ukazuje rozdíl mezi čtením a zápisem s neplatným klíčem.

Související lekce

  • JavaScript · Lekce 17 · Pokročilá · Verze: 4

Zdroje