Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Map.prototype.clear: odstránenie všetkých položiek

Metóda clear odstráni na mieste všetky dvojice kľúč–hodnota z Map, nastaví pozorovanú veľkosť na nulu a vráti undefined.

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

Syntax

map.clear()

map.clear() označí všetky existujúce položky Map ako prázdne bez vytvorenia novej kolekcie. Potom je size 0 a has, get ani iterácia odstránené kľúče nevidia. Metóda nemá významné argumenty a vždy vracia undefined, takže ju nemožno reťaziť ako set.

Existujúce iterátory sa nenahrádzajú. Preskakujú vymazané záznamy, ale iterátor, ktorý ešte neskončil s done: true, môže vidieť položky pridané do rovnakej Map po clear, pretože nové záznamy sa pripájajú k internej postupnosti. Vymazanie odstráni odkazy Map, ale uvoľnenie pamäte závisí od ďalších odkazov a garbage collectora.

Metóda vyžaduje prijímač s internými údajmi Map; Map.prototype.clear.call({}), Set alebo neošetrený Proxy obaľujúci Map vyvolá TypeError. Je štandardná od ECMAScript 2015. Použite ju na zachovanie identity Map sledovanej inde; map = new Map() zmení len túto lokálnu referenciu.

Prí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ýsledok

a
true 0
c false
true

Zdroje