CKTIS / JavaScript
Map.prototype.clear: alle items verwijderen
De methode clear verwijdert alle sleutel-waardeparen ter plaatse uit een Map, maakt de zichtbare grootte nul en geeft undefined terug.
Versie: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
map.clear()map.clear() markeert elke bestaande Map-item als leeg zonder een nieuwe verzameling te maken. Daarna is size 0 en kunnen has, get en iteratie de verwijderde sleutels niet zien. De methode heeft geen betekenisvolle argumenten en geeft altijd undefined terug, dus is niet zoals set te koppelen.
Bestaande iterators worden niet vervangen. Ze slaan gewiste records over, maar een iterator die nog niet met done: true is geëindigd kan items zien die na clear aan dezelfde Map worden toegevoegd, omdat nieuwe records achteraan de interne reeks komen. Wissen verwijdert Map-referenties, maar geheugenvrijgave hangt af van andere referenties en de garbagecollector.
De methode vereist een ontvanger met interne Map-gegevens; Map.prototype.clear.call({}), een Set of een onbehandelde Proxy rond een Map werpt TypeError. Ze is standaard sinds ECMAScript 2015. Gebruik haar om de identiteit van een elders waargenomen Map te behouden; map = new Map() wijzigt alleen die lokale referentie.
Voorbeelden
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);
}Resultaat
a true 0 c false true