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

CKTIS / JavaScript

Declaración de función generadora y método generador

Ambas formas definen funciones generadoras síncronas. La declaración vincula un nombre en su ámbito; el método pertenece a un objeto o a una clase.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

function* sequence(start) { yield start; }
const object = { *values() { yield this.start; } };
class Series { *values() { yield this.start; } }

Una declaración como function* sequence(start) { ... } vincula el nombre sequence en su ámbito. La forma *values() { ... } define un método en un objeto o clase: el asterisco se coloca antes del nombre del método y no se escribe la palabra clave function. En la llamada counter.values(), this vale counter dentro del método.

Cada llamada devuelve un generador síncrono nuevo, que es tanto un iterador como un iterable. Las instrucciones del cuerpo no se ejecutan hasta la primera llamada a next(). yield value pausa la ejecución, conserva el estado local y produce un resultado de la forma { value, done: false }. La siguiente llamada a next() reanuda la ejecución. Usar new con cualquiera de las dos funciones lanza un TypeError.

Si next() alcanza return value, el resultado es { value, done: true }. Un bucle for...of y la sintaxis de propagación ... toman los valores producidos por yield, pero omiten el valor final de return. Una vez terminado el generador, las siguientes llamadas a next() devuelven { value: undefined, done: true }. Para empezar de nuevo, vuelve a llamar a la función o al método.

Ejemplos

{
  function* sequence(start) {
    yield start;
    return start + 1;
  }

  const counter = {
    start: 7,
    *values() {
      yield this.start;
    },
  };

  const steps = sequence(3);
  for (let i = 0; i < 3; i++) {
    const { value, done } = steps.next();
    console.log(`${value} ${done}`);
  }
  console.log(JSON.stringify([...counter.values()]));
}

Resultado

3 false
4 true
undefined true
[7]

Las llamadas a `next()` muestran el `3` producido por `yield`, el `4` devuelto por `return` y el estado final. Al expandir el generador de `counter.values()` se obtiene `[7]`, porque el método lee `counter.start` mediante `this`.

Lecciones relacionadas

  • JavaScript · Lección 8 · Avanzado · Versión: 4

Fuentes