Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Map.prototype.clear : supprimer toutes les entrées

La méthode clear supprime sur place toutes les paires clé–valeur d’une Map, rend sa taille observée nulle et renvoie undefined.

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

Syntaxe

map.clear()

map.clear() marque chaque entrée existante de la Map comme vide sans créer de nouvelle collection. Ensuite, size vaut 0 et has, get ainsi que l’itération ne voient plus les clés supprimées. La méthode n’accepte aucun argument significatif et renvoie toujours undefined ; elle ne se chaîne donc pas comme set.

Les itérateurs existants ne sont pas remplacés. Ils sautent les enregistrements effacés, mais un itérateur qui n’a pas fini avec done: true peut voir les entrées ajoutées à la même Map après clear, car les nouveaux enregistrements sont ajoutés à la séquence interne. Le nettoyage retire les références de la Map, mais la récupération mémoire dépend des autres références et du ramasse-miettes.

La méthode exige un receveur doté des données internes de Map ; Map.prototype.clear.call({}), un Set ou un Proxy non géré enveloppant une Map lève TypeError. Elle est standard depuis ECMAScript 2015. Utilisez-la pour préserver l’identité d’une Map observée ailleurs ; map = new Map() ne change que la référence locale.

Exemples

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

Résultat

a
true 0
c false
true

Sources