javascript-tutorial / javascript-tutorial/ru.javascript.info
[Предложение: учебник]: `yield*` тоже работает в две стороны
Ninguém assumiu esta issue ainda.
- Linguagem predominante
- HTML
- Estrelas
- 4.1k
- Forks
- 922
- Métricas de merge de PRs
- Nenhum PR com merge em 30d
Descrição
### Описание
После прочтения главы учебника про [Генераторы](https://learn.javascript.ru/generators) мне стала интересна эта тема я и решил уделить чуть больше внимания, чем на остальные темы. И в конечном итоге я нашел одну особенность, которая не была упомянута в данной главе и которую на мой субъективный взгляд стоит добавить.
В главе было рассказано про то, что оператор `yield` работает в две стороны - при вызове метода `next` у генератора оператор возвращает значение справа, а если в метод `next` передать значение, то оно будет передано части слева от оператора `yield`.
Так вот, тоже самое работает и при композиции генераторов с использованием оператора `yield*`. Когда вложенный генератор завершает свое выполнение, выполнив последний `yield`, он ждет следующего вызова `next` и уже после исполнение переходит в генератор на уровень выше. Но я заметил, что если прописать после последнего `yield` оператор `return` с каким либо значением, то есть передать его на уровень выше, а во внешнем генераторе прописать что то типа `let data = yield* generator_func()`, то можно принять возвращенное значение.
Пример:
```js
function* f() {
yield 2;
return 3;
}
function* g() {
yield 1;
let data = yield* f();
// тут выполняются некоторые необходимые преобразования значения data
yield data;
}
let gen = g();
gen.next().value; // 1
gen.next().value; // 2
gen.next().value; // 3
```
### Мотивация
Я считаю, что для глубокого понимания концепции композиции генераторов нужно знать о вышеописанной особенности.
В доказательство могу еще привести такой пример. Я попытался реализовать систему сценариев поведения телеграмм бота через генераторы. Все сообщения от пользователя передавались в уникальный для каждого генератор, а полученные значения из этого генератора передавались как сообщения от бота пользователю. В итоге я пришел к выводу, что нужно как то передавать последнее значение `yield` в генератор уровнем выше. Так и открыл для себя данную особенность композиции генераторов в JavaScript.
Вот пример кода одного из сценариев:
```js
// Пример сценария-генератора
export default function* () {
let num1 = Number( yield `Введите первое число` );
if (isNaN(num1)) {
return yield "[1] Извините, это не число. Повторите попытку"
}
let num2 = Number( yield `Введите второе число` );
if (isNaN(num2)) {
return yield "[2] Извините, это не число. Повторите попытку"
}
return yield `Сумма ваших чисел: ${ num1 + num2 }`
}
```
### Готовы ли вы принять участие в реализации данного предложения?
Да, я готов(а) принять участие.
Guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Direção de pesquisa
Comece pelo capítulo Generators vinculado na issue e revise sua explicação existente sobre yield e yield*. Adicione uma explicação clara de como yield* encaminha o valor de retorno do gerador aninhado, usando os exemplos fornecidos; o capítulo deve abranger com precisão esse comportamento e seu uso prático.
Escrita pelo modelo de indexação a partir do texto da issue.
Avaliação
- Stack de tecnologia
- javascript
- Domínio
- documentation
- Tipo de issue
- Documentação
- Dificuldade
- 2/5
- Tempo estimado
- 1-3 horas
- Status de atividade
- Estagnada
- Clareza
- Razoavelmente clara
- Facilidade para iniciantes
- 50/100