Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

WeakMap.prototype.delete() — usuwanie wpisu

Wywołaj `weakMap.delete(key)`, aby usunąć wpis o podanym kluczu. Metoda zwraca `true`, jeśli usunęła wpis, lub `false`, jeśli go nie usunęła.

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

Składnia

weakMap.delete(key)

WeakMap.delete to skrótowa nazwa metody instancji WeakMap.prototype.delete. Wywołaj ją jako weakMap.delete(key), a nie jako metodę statyczną konstruktora WeakMap. Usuwa powiązanie klucza z wartością tylko z tej mapy. W przeciwieństwie do operatora delete nie usuwa właściwości obiektu.

Wynik true oznacza, że wpis istniał i został usunięty, nawet jeśli jego wartością było undefined. Brak wpisu daje false. Klucze obiektowe porównuje się według tożsamości: dwa różne obiekty z takimi samymi właściwościami nie pasują do siebie. Po usunięciu weakMap.has(key) zwraca false, o ile wpisu nie dodano ponownie.

ECMAScript 2024 dopuszcza jako klucze obiekty i symbole niezarejestrowane, np. Symbol(), ale nie symbole z Symbol.for(). Obsługa kluczy symbolicznych zależy od środowiska wykonawczego. Przy poprawnej instancji delete() zwraca false dla niedozwolonego klucza, np. napisu, lub przy pominięciu argumentu; set() zgłasza dla niedozwolonego klucza TypeError. Wywołanie delete() bez poprawnej instancji jako this również zgłasza TypeError.

WeakMap nie utrzymuje obiektu przy życiu tylko dlatego, że jest on kluczem. Jawne usunięcie wpisu działa od razu, nawet jeśli kod nadal ma referencję do klucza. Nie niszczy obiektu ani nie wymusza odzyskania pamięci przez mechanizm odśmiecania.

Przykłady

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

Wynik

false
true
false
false
false

Osobny obiekt `{ id: 1 }` nie pasuje do klucza `key`. Usunięcie wpisu za pomocą `key` zwraca `true` mimo wartości `undefined`. Potem `has()`, ponowne usunięcie i próba usunięcia z napisem jako kluczem zwracają `false`.

Powiązane lekcje

  • JavaScript · Lekcja 18 · Podstawowy · Wersja: 4

Źródła