CKTIS / JavaScript
Map.prototype.clear: usunięcie wszystkich wpisów
Metoda clear usuwa wszystkie pary klucz–wartość z Map w miejscu, ustawia obserwowany rozmiar na zero i zwraca undefined.
Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2
Składnia
map.clear()map.clear() oznacza każdy istniejący wpis Map jako pusty, nie tworząc nowej kolekcji. Po wywołaniu size wynosi 0, a has, get i iteracja nie widzą usuniętych kluczy. Metoda nie przyjmuje znaczących argumentów i zawsze zwraca undefined, dlatego nie można łączyć jej łańcuchowo jak set.
Istniejące iteratory nie są zastępowane. Pomijają wyczyszczone rekordy, lecz iterator, który nie zakończył się wartością done: true, może zobaczyć wpisy dodane do tej samej Map po clear, ponieważ nowe rekordy są dopisywane do wewnętrznej sekwencji. Samo czyszczenie usuwa referencje Map do kluczy i wartości, ale zwolnienie pamięci zależy od pozostałych referencji i garbage collectora.
Metoda wymaga odbiorcy z wewnętrznymi danymi Map; Map.prototype.clear.call({}), Set albo nieobsłużony Proxy opakowujący Map powoduje TypeError. Jest standardowa od ECMAScript 2015. Użyj jej do zachowania tożsamości Map obserwowanej w innych miejscach; przypisanie map = new Map() zmienia tylko lokalną referencję.
Przykłady
const map = new Map([["a", 1], ["b", 2]]);
const keys = map.keys();
console.log(keys.next().value);
const result = map.clear();
console.log(result === undefined, map.size);
map.set("c", 3);
const afterClear = keys.next();
console.log(afterClear.value, afterClear.done);
try {
Map.prototype.clear.call({});
} catch (error) {
console.log(error instanceof TypeError);
}Wynik
a true 0 c false true