Generator.prototype.next()

gen.next(value)

<var>value</var>

ジェネレーターへ送る値です。

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

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

done (boolean)

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

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

value

イテレーターが返す何らかの JavaScript の値です。 done が true の場合は省略可能です。

次の例では、 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 }"

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 }"

• function*
• イテレーターとジェネレーター