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

CKTIS / JavaScript

WeakMap.prototype.delete() — odstranění položky

Voláním `weakMap.delete(key)` odstraníš položku pro zadaný klíč. Metoda vrátí `true`, pokud položku odstranila, a `false`, pokud ji neodstranila.

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

Syntaxe

weakMap.delete(key)

WeakMap.delete je zkrácené označení instanční metody WeakMap.prototype.delete. Volej ji jako weakMap.delete(key), ne jako statickou metodu konstruktoru WeakMap. Odstraní přiřazení klíče k hodnotě pouze z této mapy. Na rozdíl od operátoru delete neodstraňuje vlastnost objektu.

true znamená, že položka existovala a byla odstraněna, i když její hodnota byla undefined. Pokud položka chybí, výsledkem je false. Objektové klíče se porovnávají podle identity: dva různé objekty se stejnými vlastnostmi se neshodují. Po odstranění vrátí weakMap.has(key) hodnotu false, pokud pro daný klíč znovu nepřidáš položku.

ECMAScript 2024 povoluje jako klíče objekty a neregistrované symboly, například Symbol(), nikoli však symboly získané pomocí Symbol.for(). Podpora symbolů jako klíčů závisí na běhovém prostředí. U platné instance vrací delete() hodnotu false pro neplatný klíč, například řetězec, nebo při vynechání argumentu. set() pro neplatný klíč vyvolá chybu TypeError. Volání delete() bez platné instance jako this také vyvolá chybu TypeError.

WeakMap neudržuje objekt naživu jen proto, že slouží jako klíč. Výslovné odstranění odebere položku ihned, i když kód stále drží odkaz na klíč. Nezničí objekt ani nevynutí uvolnění paměti správcem paměti (garbage collectorem).

Pří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ýsledek

false
true
false
false
false

Samostatný objekt `{ id: 1 }` se s `key` neshoduje. Odstranění pomocí `key` vrátí `true`, přestože uložená hodnota je `undefined`. Poté `has()`, druhé odstranění i pokus o odstranění s řetězcem jako klíčem vrátí `false`.

Související lekce

  • JavaScript · Lekce 18 · Základní · Verze: 4

Zdroje