CKTIS / JavaScript
Iteradores y generadores
Un iterador proporciona resultados sucesivos mediante next(), mientras que un objeto iterable ofrece un iterador mediante Symbol.iterator. Un generador facilita la implementación de ambos mecanismos con function* y yield.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
iterator.next() // { value, done }
iterable[Symbol.iterator]() // iterator
function* name() { yield value; }Un iterador es un objeto con un método next() que devuelve un objeto de resultado, no el elemento en sí. Un objeto iterable expone un método [Symbol.iterator]() que devuelve un iterador. Por tanto, tener solo next() no basta para poder usar un objeto en for...of.
El resultado del iterador — iterator result value/done — se describe mediante los campos value y done. Con done: false, value contiene el siguiente elemento. Con done: true, la iteración ha terminado y value puede contener un valor de retorno final. Si falta done, se considera false; si falta value, el resultado es undefined. No detectes el final comparando value con undefined: ese puede ser un elemento válido.
Al llamar a una función function* se crea un generador que es a la vez un iterador y un objeto iterable. next() reanuda la ejecución, yield proporciona un elemento y suspende la función, y return la termina. for...of y la sintaxis de propagación ... ignoran el valor del resultado cuando done: true.
Un generador conserva su estado: reutilizarlo no reinicia la iteración. Vuelve a llamar a la función generadora para empezar un recorrido nuevo. El ejemplo distingue los elementos de yield del valor final de return.
Ejemplos
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(", "));Resultado
10 | false 20 | false 99 | true undefined | true 10, 20
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.