Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Map.prototype.keys: iteratore di chiavi

Il metodo keys restituisce un iteratore vivo delle chiavi Map nell’ordine di inserimento senza copiare i valori associati.

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

Sintassi

map.keys()

map.keys() crea un nuovo iteratore Map. Ogni next() riuscito restituisce la chiave successiva nell’ordine di inserimento; le chiavi oggetto sono gli stessi riferimenti. L’iteratore non modifica la Map e chiamate separate a keys() hanno posizioni indipendenti.

L’iteratore è pigro, non un’istantanea. Salta una voce eliminata prima della visita e può vedere una voce aggiunta prima della fine. Aggiornare il valore di una chiave non crea una nuova posizione. Dopo done: true, aggiunte successive non lo riattivano. Una chiave -0 viene memorizzata e restituita come +0.

Il metodo non accetta argomenti significativi e richiede dati interni Map; oggetto, Set o Proxy non gestito genera TypeError. Standard da ECMAScript 2015. Per avere anche i valori, usare entries() o l’iterazione predefinita.

Esempi

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

Risultato

true
c false
true
true
true
true

Fonti