function*

Sintaxis

function* nombre([param[, param[, ... param]]]) {
   instrucciones
}

nombre

El nombre de la funcin.

param

El nombre de los argumentos que se le van a pasar a la funcin. Una funcin puede tener hasta 255 argumentos.

instrucciones

Las instrucciones que componen el cuerpo de la funcin.

Descripcin

Los generadores son funciones de las que se puede salir y volver a entrar. Su contexto (asociacin de variables) ser conservado entre las reentradas.

La llamada a una funcin generadora no ejecuta su cuerpo inmediatamente; se devuelve un objeto iterador para la funcin en su lugar. Cuando el metodo next() del iterador es llamado , el cuerpo de la funcin generadora es ejecutado hasta la primera expresin yield, la cual especifica el valor que ser retornado por el iterador o con, yield*, delega a otra funcin generadora. El mtodo next() retorna un objeto con una propiedad value que contiene el valor bajo el operador yield y una propiedad done que indica, con un booleano, si la funcin generadora ha hecho yield al ltimo valor.

Ejemplos

Ejemplo simple

function* idMaker() {
  var index = 0;
  while (index < 3) yield index++;
}

var gen = idMaker();

console.log(gen.next().value); // 0
console.log(gen.next().value); // 1
console.log(gen.next().value); // 2
console.log(gen.next().value); // undefined
// ...

Ejemplo con yield*

function* anotherGenerator(i) {
  yield i + 1;
  yield i + 2;
  yield i + 3;
}

function* generator(i) {
  yield i;
  yield* anotherGenerator(i);
  yield i + 10;
}

var gen = generator(10);

console.log(gen.next().value); // 10
console.log(gen.next().value); // 11
console.log(gen.next().value); // 12
console.log(gen.next().value); // 13
console.log(gen.next().value); // 20

Especificaciones

Compatibilidad con navegadores

Ver tambin

• function* expression
• GeneratorFunction object
• The Iterator protocol
• yield
• yield*
• Function object
• function declaration
• function expression
• Functions and function scope
• Other web resources:
  • Regenerator an ES2015 generator compiler to ES5
  • Forbes Lindesay: Promises and Generators: control flow utopia JSConf EU 2013
  • Hemanth.HM: The New gen of *gen(){}
  • Task.js