javascript-tutorial / javascript-tutorial/ru.javascript.info

[Предложение: учебник]: `yield*` тоже работает в две стороны

Aberta
#1,934 0 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

suggestion: tutorial
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

Abrir o guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. 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

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.