Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

WeakMap.prototype.delete(): usuwanie wpisu według klucza

Usuń wpis z `WeakMap` i sprawdź, czy rzeczywiście istniał: metoda zwraca `true`, gdy usunie wpis, a w przeciwnym razie `false`.

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

Składnia

weakMap.delete(key)

WeakMap.prototype.delete to metoda instancji. Wywołanie weakMap.delete(key) usuwa z tej mapy wpis wskazany przez key. Zwraca true tylko wtedy, gdy usunęło istniejący wpis, nawet jeśli zapisaną wartością było undefined. Jeśli wpisu nie ma, zwraca false.

Klucze są porównywane według tożsamości: dwa osobne obiekty o takich samych właściwościach to różne klucze. ECMAScript 2024 dopuszcza obiekty oraz niezarejestrowane symbole, na przykład utworzone przez Symbol(). Obsługa symboli jako kluczy zależy od środowiska wykonawczego. Dla niedozwolonego klucza, takiego jak ciąg znaków lub symbol z Symbol.for(), delete() zwraca false, podczas gdy set() zgłasza TypeError. Wywołanie metody z nieprawidłowym this, na przykład przez WeakMap.prototype.delete.call({}, key), również zgłasza TypeError.

Metoda od razu usuwa powiązanie w mapie. Nie zmienia obiektu użytego jako klucz, nie usuwa jego właściwości jak operator delete i nie wymusza odśmiecania pamięci. Użyj jej, gdy zapisane powiązanie przestaje być potrzebne, choć klucz nadal jest dostępny.

Przykłady

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

Wynik

false
true
false
false
false

Nowy obiekt `{ id: 1 }` nie pasuje do zapisanego klucza. Oryginalny `key` pozwala usunąć wpis mimo wartości `undefined`. Sprawdzenie `has()`, ponowne usunięcie i próba usunięcia wpisu z kluczem tekstowym dają `false`.

Powiązane lekcje

  • JavaScript · Lekcja 35 · Podstawowy · Wersja: 4
  • JavaScript · Lekcja 37 · Podstawowy · Wersja: 4
  • JavaScript · Lekcja 4 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 10 · Średniozaawansowany · Wersja: 3

Źródła