Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

WeakMap.set(): pridanie alebo nahradenie hodnoty

Metóda `set()` uloží hodnotu pod kľúčom v kolekcii `WeakMap`. Ak kľúč už existuje, jeho hodnotu nahradí. Vráti tú istú kolekciu, takže volania môžeš reťaziť.

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

Syntax

weakMap.set(key, value)

WeakMap.set označuje metódu inštancie WeakMap.prototype.set, nie statickú metódu konštruktora WeakMap. weakMap.set(key, value) pridá položku pre nový kľúč alebo nahradí hodnotu existujúceho kľúča. Vráti tú istú kolekciu WeakMap, takže môžeš hneď pripojiť ďalšie volanie .set(). Hodnota môže byť ľubovoľná; ak vynecháš value, uloží sa undefined.

Objektové kľúče sa porovnávajú podľa identity: dva samostatne vytvorené objekty {} sú rôzne kľúče. ECMAScript 2024 povoľuje aj neregistrované symboly, napríklad Symbol(). Staršie prostredia na vykonávanie JavaScriptu môžu ako kľúče podporovať iba objekty. Použitie reťazca, čísla, null alebo symbolu registrovaného cez Symbol.for() ako kľúča vyvolá TypeError. To isté platí, ak this pri volaní nie je inštanciou WeakMap.

Samotná položka neudržiava kľúč pri živote. Keď kľúč prestane byť dosiahnuteľný mimo tejto slabej väzby, správca pamäte ho môže uvoľniť, no nie je zaručené, kedy sa to stane. Takto môžeš ukladať doplňujúce údaje o objekte bez predĺženia jeho životnosti. Ak potrebuješ reťazcové kľúče alebo chceš prechádzať položky, použi Map.

Prí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ýsledok

true
ready
false
false
true

Prvé `true` ukazuje, že zreťazené volania vracajú tú istú kolekciu. `ready` nahrádza `pending`. Prvé `false` je uložená hodnota pre `otherTask`; druhé znamená, že nový objekt `{}` nie je kľúčom v kolekcii. Posledné `true` potvrdzuje, že reťazcový kľúč vyvolal `TypeError`.

Súvisiace lekcie

  • JavaScript · Lekcia 18 · Základná · Verzia: 4

Zdroje