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

CKTIS / JavaScript

Función generadora: function*

Una función generadora crea un iterador cuya ejecución puede pausarse en yield y reanudarse mediante next(). Calcula valores bajo demanda y conserva el estado local entre pasos sucesivos.

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

function* name(parameters) {
  yield value;
  return finalValue;
}

La declaración function* name(parameters) { ... } define una función generadora. Al llamarla, se crea un nuevo objeto Generator, pero el cuerpo de la función todavía no se ejecuta. Cada objeto tiene su propio estado de ejecución; el primer next() inicia el cuerpo, y yield value entrega un valor y pausa la ejecución.

Otro next() reanuda la ejecución después de yield y conserva las variables locales. El resultado tiene los campos value y done: yield produce done: false, mientras que return finalValue termina el generador con done: true. Sin un return explícito, el valor final es undefined. Una vez terminado, las llamadas posteriores a next() devuelven value: undefined y done: true.

Un objeto generador es tanto un iterador como un objeto iterable. for...of y la sintaxis de propagación (...) en los literales de array y en las listas de argumentos de las llamadas a funciones consumen los valores de yield, pero excluyen el valor final de return. En los literales de objeto, la propagación no hace avanzar el generador, sino que copia las propiedades propias enumerables del objeto generador. Un generador agotado no puede reiniciarse; en su lugar, vuelve a llamar a la función. Un argumento de next(value) pasa a ser el resultado de la expresión yield pausada; el argumento del primer next() se ignora.

También puedes definir un generador con una expresión como const make = function* () { yield 1; };, donde el nombre de la función es opcional. No existe una sintaxis de función flecha generadora. MDN clasifica function* como ampliamente disponible en los navegadores desde septiembre de 2016; comprueba por separado la compatibilidad del navegador de destino.

Ejemplos

function* steps() {
  yield 10;
  yield 20;
  return 30;
}

const iterator = steps();
for (let i = 0; i < 4; i++) {
  const { value, done } = iterator.next();
  console.log(`${value} | ${done}`);
}
console.log([...steps()].join(", "));

Resultado

10 | false
20 | false
30 | 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