CKTIS / JavaScript
yield — suspender um gerador
A expressão `yield` suspende um gerador e disponibiliza um valor a quem o consome. Uma chamada posterior a `next(value)` retoma a execução e fornece um valor à expressão suspensa; `yield*` delega a iteração.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
yield;
yield expression;
yield* iterable;yield expression suspende um gerador, preservando o seu estado. Num gerador síncrono, next() devolve então { value, done: false }. Um yield sem operando disponibiliza undefined. A chamada de uma função function* cria um gerador; o respetivo corpo só começa a ser executado no primeiro next().
O argumento de uma chamada posterior a next(value) passa a ser o resultado da expressão yield suspensa. O argumento do primeiro next() é ignorado. Quando o gerador termina com return value, o resultado é { value, done: true }. Se return value fizer a execução sair de um bloco try e for executado um yield no bloco finally correspondente, o gerador pode voltar a suspender-se e produzir um resultado com done: false antes de o retorno pendente se concluir.
yield* iterable delega a iteração e transmite os valores produzidos; o resultado da expressão é o valor final do iterador delegado. As expressões yield são permitidas nos corpos de geradores síncronos e assíncronos, mas não nos respetivos parâmetros nem em funções normais ou arrow aninhadas. Nos geradores assíncronos, next() devolve uma promise com um resultado de iteração.
Não coloques uma quebra de linha entre yield e o seu operando ou *: isso pode alterar a análise sintática ou causar um erro de sintaxe. yield não pode ser um identificador em código strict nem em contextos gramaticais reservados para geradores; alguns outros contextos não-strict permitem-no.
Exemplos
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}O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.