Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti