CKTIS / JavaScript
Map.prototype.keys : itérateur de clés
La méthode keys renvoie un itérateur vivant des clés de Map dans l’ordre d’insertion sans copier les valeurs associées.
Version : ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
map.keys()map.keys() crée un nouvel itérateur de Map. Chaque next() réussi renvoie la clé suivante dans l’ordre d’insertion ; les clés objets restent les mêmes références. L’itérateur ne modifie pas la Map et des appels distincts à keys() ont des positions indépendantes.
L’itérateur est paresseux, pas une capture. Il saute une entrée supprimée avant sa visite et peut voir une entrée ajoutée avant la fin. Modifier la valeur d’une clé ne crée pas de nouvelle position. Après un premier done: true, des ajouts ultérieurs ne le relancent pas. Une clé -0 est stockée et renvoyée comme +0.
La méthode n’accepte aucun argument significatif et exige les données internes de Map ; objet, Set ou Proxy non géré lève TypeError. Standard depuis ECMAScript 2015. Pour obtenir aussi les valeurs, utilisez entries() ou l’itération par défaut.
Exemples
const objectKey = {};
const map = new Map([[objectKey, 1], ["b", 2]]);
const keys = map.keys();
console.log(keys.next().value === objectKey);
map.delete("b");
map.set("c", 3);
const second = keys.next();
console.log(second.value, second.done);
console.log(keys.next().done);
map.set("d", 4);
console.log(keys.next().done);
const zeroKey = new Map([[-0, "zero"]]).keys().next().value;
console.log(Object.is(zeroKey, 0));
try { Map.prototype.keys.call({}); } catch (error) { console.log(error instanceof TypeError); }Résultat
true c false true true true true