Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Map.prototype.clear: rimuovere tutte le voci

Il metodo clear rimuove sul posto tutte le coppie chiave–valore di una Map, rende zero la dimensione osservabile e restituisce undefined.

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

Sintassi

map.clear()

map.clear() contrassegna come vuota ogni voce esistente della Map senza creare una nuova raccolta. Dopo, size è 0 e has, get e l’iterazione non vedono le chiavi rimosse. Il metodo non accetta argomenti significativi e restituisce sempre undefined, quindi non è concatenabile come set.

Gli iteratori esistenti non vengono sostituiti. Saltano i record cancellati, ma un iteratore non ancora terminato con done: true può vedere le voci aggiunte alla stessa Map dopo clear, perché i nuovi record sono accodati alla sequenza interna. La pulizia rimuove i riferimenti della Map, ma il recupero della memoria dipende da altri riferimenti e dal garbage collector.

Il metodo richiede un ricevitore con dati interni Map; Map.prototype.clear.call({}), un Set o un Proxy non gestito che avvolge una Map genera TypeError. È standard da ECMAScript 2015. Usarlo preserva l’identità di una Map osservata altrove; assegnare map = new Map() cambia solo il riferimento locale.

Esempi

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

Risultato

a
true 0
c false
true

Fonti