JavaScript

：

：

Generator.prototype.next()メソッド

　編集：2022.07.28 by T.A.

→

2つのプロパティ done と value を持つオブジェクトを返します。

next メソッドに引数を提供して、ジェネレーターへ値を送ることもできます。

gen.next(value)
gen
value ジェネレーターへ送る値です。

この値は yield 式の結果として代入されます。例えば variable = yield expression の場合、.next() 関数に渡された値は variable に代入されます。

戻り値

以下の２つのプロパティを持った Object です。

done [boolean]
イテレーターが反復処理の末尾を過ぎている場合、値は true になります。この場合、value はオプションでそのイテレーターの返値を指定します。

イテレーターが反復処理の次の値を生成することができた場合、値は false になります。これは done プロパティを指定しない場合も同等です。

value
イテレーターが返す何らかの JavaScript の値です。done が true の場合は省略可能です。
例
next() の使用

次の例では、next メソッドが返す簡単なジェネレーターとオブジェクトを示します。 

//コンソールにて
function* gen() {
  yield 1;
  yield 2;
  yield 3;
}

const g = gen(); // "Generator { }"
g.next();      // "Object { value: 1, done: false }"
g.next();      // "Object { value: 2, done: false }"
g.next();      // "Object { value: 3, done: false }"
g.next();      // "Object { value: undefined, done: true }"
リストでの next() の使用
//コンソールにて
function* getPage(pageSize = 1, list) {
    let output = [];
    let index = 0;

    while (index < list.length) {
        output = [];
        for (let i = index; i < index + pageSize; i++) {
            if (list[i]) {
                output.push(list[i]);
            }
        }

        yield output;
        index += pageSize;
    }
}

list = [1, 2, 3, 4, 5, 6, 7, 8]
var page = getPage(3, list);              // Generator { }

page.next();                              // Object {value: (3) [1, 2, 3], done: false}
page.next();                              // Object {value: (3) [4, 5, 6], done: false}
page.next();                              // Object {value: (2) [7, 8], done: false}
page.next();                              // Object {value: undefined, done: true}
ジェネレーターへ値を送る

この例では next を値付きで呼び出しています。

なお、最初の呼び出しではジェネレーターが何も生成していないため、何もログを記録しないことに注意してください。 

//コンソールにて
function* gen() {
  while (true) {
    let value = yield null;
    console.log(value);
  }
}

const g = gen();
g.next(1);
// "{ value: null, done: false }"
g.next(2);
// 2
// "{ value: null, done: false }"
テスト