Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła