CKTIS / JavaScript
Iteratori di Map: next(), value e done
Avanza in un iteratore di Map con `next()` e verifica `done` per distinguere un valore `undefined` memorizzato dalla fine dell’iterazione.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
const iterator = map.entries(); // or map.keys(), map.values(), map[Symbol.iterator]()
const { value, done } = iterator.next();Chiama iterator.next() per avanzare di un passo. Il metodo appartiene all’iteratore, non alla Map, e restituisce un oggetto risultato con value e done. Leggere result.value non fa avanzare l’iteratore; chiamare di nuovo next() sì. Conserva il risultato se ti servono entrambe le proprietà dello stesso passo. Chiamare il metodo next separatamente, senza il this corretto, genera un TypeError.
map.keys() produce le chiavi e map.values() i valori memorizzati. map.entries() e map[Symbol.iterator]() producono un nuovo array di due elementi [key, value] in result.value a ogni passo che restituisce un elemento. Tutti e tre i tipi visitano le voci in ordine di inserimento. Controlla done, non value: done: false indica che è stato prodotto un elemento, anche se value è undefined. Un iteratore di Map esaurito restituisce { value: undefined, done: true }.
L’iteratore non è una copia statica: può vedere le voci aggiunte prima dell’esaurimento, ma una volta restituito done: true non riparte più. Crea un nuovo iteratore per ricominciare. Questo è il comportamento della Map integrata in ECMAScript 2024; il supporto varia a seconda dell’ambiente di esecuzione.
Esempi
{
const map = new Map([["a", undefined], ["b", 7]]);
const iterator = map.values();
function logStep({ value, done }) {
console.log(`done=${done}, value=${value}`);
}
logStep(iterator.next());
logStep(iterator.next());
logStep(iterator.next());
map.set("c", 9);
logStep(iterator.next());
console.log(JSON.stringify(map.entries().next().value));
}Risultato
done=false, value=undefined done=false, value=7 done=true, value=undefined done=true, value=undefined ["a",null]
Il primo passo produce un `undefined` memorizzato; il terzo segnala la fine. Aggiungere `"c"` non riattiva l’iteratore. Un nuovo iteratore delle voci parte da `"a"`; nell’ultima riga, `JSON.stringify()` rappresenta l’elemento `undefined` dell’array come `null`, senza modificare la Map.
Lezioni correlate
- JavaScript · Lezione 7 · Avanzato · Versione: 4
Fonti
- ECMAScript 2024 Language Specification — Map Iterator Objects
- ECMAScript Language Specification — Properties of the Map Prototype Object
- ECMAScript Language Specification — Map Iterator Objects
- ECMAScript 2024 Language Specification — GeneratorResume
- ECMAScript 2024 Language Specification — GeneratorValidate