KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

WeakMap.prototype.delete() — een item verwijderen

Roep `weakMap.delete(key)` aan om het item voor een sleutel te verwijderen. De methode geeft `true` terug als er een item is verwijderd, anders `false`.

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

Syntax

weakMap.delete(key)

WeakMap.delete is een verkorte naam voor de instantiemethode WeakMap.prototype.delete. Roep die aan als weakMap.delete(key), niet als statische methode op de constructor WeakMap. De methode verwijdert de koppeling tussen sleutel en waarde alleen uit die map. Anders dan de operator delete verwijdert ze geen eigenschap van een object.

true betekent dat er een item was en dat het is verwijderd, ook als de waarde undefined was. Ontbreekt het item, dan krijg je false. Objectsleutels worden op identiteit vergeleken: twee afzonderlijke objecten met dezelfde eigenschappen komen niet overeen. Na verwijdering geeft weakMap.has(key) false terug, tenzij je opnieuw een item voor die sleutel toevoegt.

ECMAScript 2024 staat objecten en niet-geregistreerde symbolen zoals Symbol() toe als sleutels, maar geen symbolen uit Symbol.for(). Ondersteuning voor symboolsleutels verschilt per runtime. Op een geldige instantie geeft delete() false terug bij een ongeldige sleutel, zoals een tekenreeks, of als je het argument weglaat; set() gooit bij een ongeldige sleutel een TypeError. Ook delete() gooit een TypeError als this geen geldige instantie is.

Een WeakMap houdt een object niet in leven alleen omdat het als sleutel dient. Expliciete verwijdering haalt het item meteen weg, zelfs als je code nog een verwijzing naar de sleutel heeft. Ze vernietigt het object niet en dwingt geen garbagecollection af.

Voorbeelden

{
  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"));
}

Resultaat

false
true
false
false
false

Het afzonderlijke object `{ id: 1 }` komt niet overeen met `key`. Verwijderen met `key` geeft `true` terug, ook al is de opgeslagen waarde `undefined`. Daarna geven `has()`, een tweede verwijdering en een verwijderpoging met een tekenreeks als sleutel elk `false` terug.

Gerelateerde lessen

  • JavaScript · Les 18 · Basis · Versie: 4

Bronnen