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

CKTIS / JavaScript

WeakMap.prototype.delete() — odstránenie položky

Volaním `weakMap.delete(key)` odstrániš položku pre zadaný kľúč. Metóda vráti `true`, ak položku odstránila, a `false`, ak ju neodstránila.

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

Syntax

weakMap.delete(key)

WeakMap.delete je skrátený názov inštančnej metódy WeakMap.prototype.delete. Volaj ju ako weakMap.delete(key), nie ako statickú metódu konštruktora WeakMap. Odstráni priradenie kľúča k hodnote iba z tejto mapy. Na rozdiel od operátora delete neodstraňuje vlastnosť objektu.

true znamená, že položka existovala a bola odstránená, aj keď jej hodnota bola undefined. Ak položka chýba, výsledkom je false. Objektové kľúče sa porovnávajú podľa identity: dva odlišné objekty s rovnakými vlastnosťami sa nezhodujú. Po odstránení vráti weakMap.has(key) hodnotu false, pokiaľ pre daný kľúč znova nepridáš položku.

ECMAScript 2024 povoľuje ako kľúče objekty a neregistrované symboly, napríklad Symbol(), ale nie symboly získané pomocou Symbol.for(). Podpora symbolov ako kľúčov závisí od behového prostredia. Na platnej inštancii vracia delete() hodnotu false pri neplatnom kľúči, napríklad reťazci, alebo pri vynechaní argumentu. set() pri neplatnom kľúči vyvolá chybu TypeError. Volanie delete() bez platnej inštancie ako this tiež vyvolá chybu TypeError.

WeakMap nedrží objekt pri živote len preto, že slúži ako kľúč. Explicitné odstránenie vymaže položku ihneď, aj keď si kód stále uchováva referenciu na kľúč. Nezničí objekt ani nevynúti uvoľnenie pamäte mechanizmom garbage collection.

Príklady

{
  const notes = new WeakMap();
  const key = { id: 1 };
  notes.set(key, undefined);

  console.log(notes.delete({ id: 1 }));
  console.log(notes.delete(key));
  console.log(notes.has(key));
  console.log(notes.delete(key));
  console.log(notes.delete("id"));
}

Výsledok

false
true
false
false
false

Samostatný objekt `{ id: 1 }` sa nezhoduje s `key`. Odstránenie pomocou `key` vráti `true`, aj keď uložená hodnota je `undefined`. Potom `has()`, druhé odstránenie aj pokus o odstránenie s reťazcom ako kľúčom vrátia `false`.

Súvisiace lekcie

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

Zdroje