Generator.prototype.next()
next()
メソッドは、2 つのプロパティ done
と value
を持つオブジェクトを返します。 next
メソッドに引数を提供して、ジェネレーターへ値を送ることもできます。
構文
gen.next(value)
引数
<var>value</var>
-
ジェネレーターへ送る値です。
この値は
yield
式の結果として代入されます。例えば<var>variable</var> = yield <var>expression</var>
の場合、.next()
関数に渡された値は<var>variable</var>
に代入されます。
返値
以下の2つのプロパティを持った 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 }"
仕様書
Specification |
---|
ECMAScript Language Specification # sec-generator.prototype.next |
ブラウザーの互換性
BCD tables only load in the browser