Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła