CKTIS / JavaScript
Map.prototype.delete: usunięcie wpisu po kluczu
Metoda delete usuwa z Map wpis pasujący do podanego klucza i zwraca true tylko wtedy, gdy taki wpis istniał.
Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2
Składnia
map.delete(key)map.delete(key) wyszukuje klucz bez konwersji typu. Jeśli wpis istnieje, oznacza go jako pusty i zwraca true; w przeciwnym razie nie zmienia Map i zwraca false. Usuwana jest cała para klucz–wartość, a size zmniejsza się o jeden tylko przy udanym usunięciu.
Klucze stosują semantykę SameValueZero: NaN pasuje do NaN, a -0 do +0; obiekty pasują wyłącznie przez tożsamość referencji. Kolejność pozostałych wpisów nie zmienia się. Ponowne set tego samego klucza po usunięciu tworzy nowy wpis na końcu kolejności iteracji, a aktywne iteratory pomijają usunięty rekord.
Odbiorca musi być prawdziwą Map z wewnętrznymi danymi; wywołanie metody z obiektem, Set lub nieobsłużonym Proxy jako this powoduje TypeError. Metoda jest standardowa od ECMAScript 2015. Zwrócony boolean pozwala rozróżnić brak klucza od istniejącego wpisu, którego wartością było undefined.
Przykłady
const token = {};
const map = new Map([[token, "active"], [NaN, "unknown"], ["tail", 3]]);
console.log(map.delete({}), map.size);
console.log(map.delete(token), map.has(token), map.size);
console.log(map.delete(NaN), map.delete(NaN));
const ordered = new Map([["a", 1], ["b", 2]]);
ordered.delete("a");
ordered.set("a", 3);
console.log([...ordered.keys()].join(","));
try {
Map.prototype.delete.call({}, "a");
} catch (error) {
console.log(error instanceof TypeError);
}Wynik
false 3 true false 2 true false b,a true