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

Описание

После прочтения главы учебника про Генераторы мне стала интересна эта тема я и решил уделить чуть больше внимания, чем на остальные темы. И в конечном итоге я нашел одну особенность, которая не была упомянута в данной главе и которую на мой субъективный взгляд стоит добавить.

В главе было рассказано про то, что оператор yield работает в две стороны - при вызове метода next у генератора оператор возвращает значение справа, а если в метод next передать значение, то оно будет передано части слева от оператора yield.

Так вот, тоже самое работает и при композиции генераторов с использованием оператора yield*. Когда вложенный генератор завершает свое выполнение, выполнив последний yield, он ждет следующего вызова next и уже после исполнение переходит в генератор на уровень выше. Но я заметил, что если прописать после последнего yield оператор return с каким либо значением, то есть передать его на уровень выше, а во внешнем генераторе прописать что то типа let data = yield* generator_func(), то можно принять возвращенное значение.

Пример:

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.

Вот пример кода одного из сценариев:

// Пример сценария-генератора
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 }`
}

Готовы ли вы принять участие в реализации данного предложения?

Да, я готов(а) принять участие.

issue にリンクされている Generators の章から始め、yield と yield* についての既存の説明を確認してください。提供された例を使って、yield* がネストされたジェネレーターの戻り値をどのように転送するかを明確に説明してください。この章では、この動作とその実際の用途を正確に扱う必要があります。