Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri