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.