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

CKTIS / JavaScript

WeakMap.prototype.delete(): odstranění položky podle klíče

Odstraňte položku z `WeakMap` a podle návratové hodnoty zjistěte, zda se skutečně nějaká položka odstranila.

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

Syntaxe

weakMap.delete(key)

WeakMap.prototype.delete je instanční metoda. Volání weakMap.delete(key) odstraní z dané mapy položku s klíčem key. Vrátí true, pouze pokud odstranilo existující položku, a to i v případě, že uložená hodnota byla undefined. Pokud položka neexistuje, vrátí false.

Klíče se porovnávají podle identity: dva samostatné objekty se stejnými vlastnostmi jsou různé klíče. ECMAScript 2024 povoluje objekty a neregistrované symboly, například symboly vytvořené pomocí Symbol(). Podpora symbolů jako klíčů závisí na běhovém prostředí. Pro neplatný klíč, například řetězec nebo symbol získaný pomocí Symbol.for(), vrací delete() hodnotu false, zatímco set() vyvolá výjimku TypeError. Volání s neplatným this, například WeakMap.prototype.delete.call({}, key), také vyvolá výjimku TypeError.

Metoda okamžitě odstraní vazbu mezi klíčem a hodnotou. Nemění objekt použitý jako klíč, nemaže žádnou z jeho vlastností jako operátor delete ani nevynucuje automatické uvolnění paměti. Použijte ji, když uloženou vazbu už nepotřebujete, ale klíč máte stále k dispozici.

Příklady

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

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

Výsledek

false
true
false
false
false

Nový objekt `{ id: 1 }` se neshoduje s uloženým klíčem. Původní `key` umožní odstranit položku, i když má hodnotu `undefined`. Kontrola pomocí `has()`, opakované odstranění i pokus s řetězcem jako klíčem vrátí `false`.

Související lekce

  • JavaScript · Lekce 35 · Základní · Verze: 4
  • JavaScript · Lekce 37 · Základní · Verze: 4
  • JavaScript · Lekce 4 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 10 · Středně pokročilá · Verze: 3

Zdroje