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

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

Sources