Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Map.prototype.clear: odstranění všech položek

Metoda clear odstraní na místě všechny dvojice klíč–hodnota z Map, nastaví pozorovanou velikost na nulu a vrátí undefined.

Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntaxe

map.clear()

map.clear() označí všechny existující položky Map jako prázdné, aniž vytvoří novou kolekci. Poté je size 0 a has, get ani iterace odstraněné klíče nevidí. Metoda nemá žádné významné argumenty a vždy vrací undefined, takže ji nelze řetězit jako set.

Existující iterátory se nenahrazují. Přeskakují vymazané záznamy, ale iterátor, který ještě neskončil s done: true, může vidět položky přidané do stejné Map po clear, protože nové záznamy se připojují k interní posloupnosti. Vymazání odstraní odkazy Map, ale uvolnění paměti závisí na dalších odkazech a garbage collectoru.

Metoda vyžaduje příjemce s interními daty Map; Map.prototype.clear.call({}), Set nebo neošetřený Proxy obalující Map vyvolá TypeError. Je standardní od ECMAScript 2015. Použijte ji pro zachování identity Map sledované jinde; map = new Map() změní pouze tuto lokální referenci.

Příklady

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);
}

Výsledek

a
true 0
c false
true

Zdroje