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

CKTIS / JavaScript

WeakMap: kontrola, čítanie a zápis položiek pomocou has(), get() a set()

Zisti, či kľúč existuje, prečítaj jeho hodnotu alebo ju zmeň. Nauč sa odlíšiť chýbajúcu položku od uloženého `undefined` a zisti, ktoré kľúče `WeakMap` prijíma.

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

Syntax

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

WeakMap.prototype.has/get/set je skratka pre tri metódy inštancie WeakMap. Kľúče sa porovnávajú podľa identity: dva samostatné objekty s rovnakými vlastnosťami sú rôzne kľúče.

  • has(key) vráti true, ak položka existuje, inak false.
  • get(key) vráti uloženú hodnotu alebo undefined, ak položka neexistuje. Použi has(key), aby si odlíšil chýbajúcu položku od uloženého undefined.
  • set(key, value) pridá položku alebo nahradí hodnotu priradenú k tomu istému kľúču. Prijíma ľubovoľnú hodnotu JavaScriptu a vracia tú istú inštanciu WeakMap, takže volania môžeš reťaziť.

ECMAScript 2024 povoľuje ako kľúče objekty (vrátane funkcií) a neregistrované symboly, napríklad Symbol() a Symbol.iterator, ale nie symboly získané pomocou Symbol.for(). Staršie prostredia môžu prijímať iba objektové kľúče; over si podporu symbolov ako kľúčov v cieľovom prostredí.

Pri neplatnom kľúči, napríklad 1, vráti has() hodnotu false, get() vráti undefined a set() vyvolá výnimku TypeError. Všetky tri metódy najprv kontrolujú this: ak to nie je skutočná inštancia WeakMap, volanie vyvolá výnimku TypeError bez ohľadu na kľúč.

WeakMap umožňuje priradiť k objektu metadáta bez toho, aby kľúč udržiavala pri živote, aj keď uložená hodnota odkazuje na kľúč. Nie je zaručené, kedy sa pamäť uvoľní. WeakMap neumožňuje prechádzať kľúče ani neposkytuje size; použi Map, ak tieto možnosti potrebuješ alebo chceš použiť reťazce či čísla ako kľúče.

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

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

`key` a `lookalike` majú rovnaké `id`, ale sú to rôzne objekty. Obe čítania najprv vrátia `undefined`; iba `has(key)` vráti `true`. Druhý zápis nahradí hodnotu číslom `42` a vráti tú istú mapu. Kľúč `1` ukazuje rozdiel medzi čítaním a zápisom pri neplatnom kľúči.

Súvisiace lekcie

  • JavaScript · Lekcia 17 · Pokročilá · Verzia: 4

Zdroje