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

CKTIS / JavaScript

yield — suspender un generador

La expresión `yield` suspende un generador y ofrece un valor a quien lo consume. Una llamada posterior a `next(value)` reanuda la ejecución y proporciona un valor a la expresión suspendida; `yield*` delega la iteración.

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

yield;
yield expression;
yield* iterable;

yield expression suspende un generador y conserva su estado. En un generador síncrono, next() devuelve entonces { value, done: false }. Un yield sin operando ofrece undefined. Al llamar a una función function* se crea un generador; su cuerpo no empieza a ejecutarse hasta el primer next().

El argumento de una llamada posterior a next(value) se convierte en el resultado de la expresión yield suspendida. El argumento del primer next() se ignora. Cuando el generador termina con return value, el resultado es { value, done: true }. Si return value hace que se salga de un bloque try y en el bloque finally correspondiente se ejecuta un yield, el generador puede volver a suspenderse y producir un resultado con done: false antes de que se complete el retorno pendiente.

yield* iterable delega la iteración y transmite los valores producidos; el resultado de la expresión es el valor final del iterador delegado. Las expresiones yield están permitidas en los cuerpos de generadores síncronos y asíncronos, pero no en sus parámetros ni en funciones normales o flecha anidadas. En los generadores asíncronos, next() devuelve una promesa con un resultado de iteración.

No pongas un salto de línea entre yield y su operando o *: puede cambiar el análisis sintáctico o provocar un error de sintaxis. yield no puede ser un identificador en código estricto ni en contextos gramaticales reservados para generadores; algunos otros contextos no estrictos sí lo permiten.

Ejemplos

function* exchange() {
  const received = yield 10;
  yield received + 1;
  return 99;
}

const iterator = exchange();
for (const result of [iterator.next(), iterator.next(20), iterator.next()]) {
  console.log(JSON.stringify(result));
}

Resultado

{"value":10,"done":false}
{"value":21,"done":false}
{"value":99,"done":true}

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