Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes