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

CKTIS / JavaScript

WeakMap.prototype.set(): uloženie hodnoty pod kľúčom

Metóda `set()` pridá do `WeakMap` novú položku alebo nahradí hodnotu pri existujúcom kľúči. Vráti tú istú inštanciu, takže volania možno reťaziť.

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

Syntax

weakMap.set(key, value)

WeakMap.prototype.set je metóda prototypu, ktorá sa volá na inštancii: weakMap.set(key, value). Pridá položku pre nový kľúč alebo nahradí hodnotu pri tom istom kľúči. Vráti tú istú inštanciu, nie uloženú hodnotu, takže môže nasledovať ďalšie volanie .set(). Hodnotou môže byť ľubovoľná hodnota JavaScriptu vrátane undefined.

Objektové kľúče sa porovnávajú podľa identity: dva rôzne objekty s rovnakými vlastnosťami sú rôzne kľúče. ECMAScript 2024 povoľuje aj neregistrované symboly ako Symbol("id"). Symboly získané pomocou Symbol.for("id") ani iné primitívne hodnoty, napríklad reťazce, nie sú platné kľúče. Staršie prostredia nemusia podporovať symboly ako kľúče; overte si cieľové prostredie.

Neplatný kľúč vyvolá chybu TypeError. Rovnakú chybu vyvolá aj volanie samostatne odovzdanej metódy bez správneho this: prijímateľom volania musí byť inštancia WeakMap.

Samotná položka neudržiava kľúč pri živote. Ak už kľúč nie je dosiahnuteľný inou cestou, správca pamäte ho môže odstrániť; nespoliehajte sa na to, kedy sa to stane. Kľúče WeakMap sa nedajú vymenovať. Ak potrebujete prechádzať kľúče alebo používať reťazce ako kľúče, zvoľte namiesto toho Map.

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

10
true
20
false
true

Prvé čítanie vráti `10`, čítanie po aktualizácii vráti `20`. Výsledkom porovnania `returned === metadata` je `true`. Nový objekt s rovnakým `id` nie je uloženým kľúčom, preto `has()` vráti `false`. Pokus použiť reťazec ako kľúč vyvolá chybu `TypeError`, ktorá sa zachytí.

Súvisiace lekcie

  • JavaScript · Lekcia 35 · Základná · Verzia: 4
  • JavaScript · Lekcia 37 · Základná · Verzia: 4
  • JavaScript · Lekcia 4 · Stredne pokročilá · Verzia: 3
  • JavaScript · Lekcia 10 · Stredne pokročilá · Verzia: 3

Zdroje