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