CKTIS / JavaScript
Map.prototype.entries: iteratore di coppie chiave–valore
Il metodo entries restituisce un iteratore vivo di coppie [key, value] nell’ordine di inserimento ed è l’iterazione predefinita di Map.
Versione: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintassi
map.entries()map.entries() crea un nuovo oggetto iteratore Map. Ogni next() riuscito restituisce un nuovo array di due elementi [key, value]; modificare tale array non cambia la voce Map, anche se gli oggetti contenuti restano gli stessi riferimenti. map[Symbol.iterator] è la stessa funzione di map.entries, quindi for...of e spread ricevono coppie per impostazione predefinita.
L’iteratore è pigro, non un’istantanea. Mantiene l’ordine di inserimento, salta le voci eliminate prima della visita e può vedere voci aggiunte prima di raggiungere la fine; aggiornare una chiave non ancora visitata produce il nuovo valore. Dopo che next() ha restituito done: true, aggiunte successive non riattivano quell’iteratore.
Il metodo non accetta argomenti significativi e richiede un ricevitore con dati interni Map; usarlo con oggetto, Set o Proxy non gestito genera TypeError. È standard da ECMAScript 2015. Se servono solo chiavi o valori, keys() o values() evitano gli array di coppie.
Esempi
const map = new Map([["a", 1], ["b", 2]]);
const entries = map.entries();
const first = entries.next().value;
console.log(JSON.stringify(first));
first[1] = 99;
console.log(map.get("a"));
map.delete("b");
map.set("c", 3);
const second = entries.next();
console.log(JSON.stringify(second.value), second.done);
console.log(entries.next().done);
map.set("d", 4);
console.log(entries.next().done);
console.log(map[Symbol.iterator] === map.entries);Risultato
["a",1] 1 ["c",3] false true true true