CKTIS / JavaScript
Map.prototype.clear: odstranitev vseh vnosov
Metoda clear na mestu odstrani vse pare ključ–vrednost iz Map, nastavi opazovano velikost na nič in vrne undefined.
Različica: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaksa
map.clear()map.clear() označi vse obstoječe vnose Map kot prazne, ne da bi ustvaril novo zbirko. Nato je size 0 in has, get ter iteracija ne vidijo odstranjenih ključev. Metoda nima pomenljivih argumentov in vedno vrne undefined, zato je ni mogoče verižiti kot set.
Obstoječi iteratorji niso zamenjani. Preskočijo izbrisane zapise, toda iterator, ki se še ni končal z done: true, lahko vidi vnose, dodane v isti Map po clear, saj se novi zapisi dodajo na konec notranjega zaporedja. Čiščenje odstrani sklice Map, sprostitev pomnilnika pa je odvisna od drugih sklicev in zbiralnika smeti.
Metoda zahteva prejemnika z notranjimi podatki Map; Map.prototype.clear.call({}), Set ali neobravnavan Proxy okoli Map sproži TypeError. Standardna je od ECMAScript 2015. Uporabite jo za ohranitev identitete Map, ki jo opazujejo drugje; map = new Map() spremeni le lokalni sklic.
Primeri
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);
}Rezultat
a true 0 c false true