CKTIS / JavaScript
Iteratori e generatori
Un iteratore espone risultati successivi tramite next(), mentre un oggetto iterabile fornisce un iteratore tramite Symbol.iterator. Un generatore semplifica l’implementazione di entrambi i meccanismi con function* e yield.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
iterator.next() // { value, done }
iterable[Symbol.iterator]() // iterator
function* name() { yield value; }Un iteratore è un oggetto con un metodo next() che restituisce un oggetto risultato, non l’elemento stesso. Un oggetto iterabile espone un metodo [Symbol.iterator]() che restituisce un iteratore. Avere solo next() non basta quindi per usare un oggetto in for...of.
Il risultato dell’iteratore — iterator result value/done — è descritto dai campi value e done. Con done: false, value contiene l’elemento successivo. Con done: true, l’iterazione è terminata e value può contenere un valore finale restituito. Se done è assente, viene considerato false; se manca value, il risultato è undefined. Non rilevare la fine confrontando value con undefined: può essere un elemento valido.
La chiamata a una funzione function* crea un generatore che è sia un iteratore sia un oggetto iterabile. next() riprende l’esecuzione, yield fornisce un elemento e sospende la funzione, mentre return la termina. for...of e la sintassi spread ... ignorano il valore del risultato con done: true.
Un generatore conserva il proprio stato: riutilizzarlo non riavvia l’iterazione. Chiama di nuovo la funzione generatrice per iniziare un nuovo percorso. L’esempio distingue gli elementi prodotti da yield dal valore finale di return.
Esempi
function* numbers() {
yield 10;
yield 20;
return 99;
}
const iterator = numbers();
for (let i = 0; i < 4; i++) {
const { value, done } = iterator.next();
console.log(`${String(value)} | ${done}`);
}
console.log([...numbers()].join(", "));Risultato
10 | false 20 | false 99 | true undefined | true 10, 20
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.