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
- ECMAScript 2024 Language Specification — WeakMap.prototype.delete (key)
- ECMAScript Language Specification — WeakMap.prototype.delete (key)
- ECMAScript 2024 Language Specification — CanBeHeldWeakly (v)
- ECMAScript 2024 Language Specification — WeakMap Objects
- ECMAScript 2024 Language Specification — The delete Operator
- MDN — WeakMap.prototype.delete()
- MDN — WeakMap browser compatibility