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.