AsyncGenerator.prototype.next()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Januar 2020.
Die next()-Methode von AsyncGenerator-Instanzen gibt den nächsten Wert in der Sequenz zurück.
Syntax
next()
next(value)
Parameter
valueOptional-
Ein optionaler Wert, der verwendet wird, um den internen Zustand des Generators zu ändern. Ein an die
next()-Methode übergebener Wert wird vonyieldempfangen.
Rückgabewert
Ein Promise, das beim Auflösen ein Object mit zwei Eigenschaften zurückgibt:
done-
Ein boolescher Wert:
true, wenn der Generator das Ende seines Kontrollflusses erreicht hat. In diesem Fall gibtvalueden Rückgabewert des Generators an (der möglicherweise undefiniert ist).false, wenn der Generator in der Lage ist, weitere Werte zu erzeugen.
value-
Jeder JavaScript-Wert, der vom Generator "yielded" oder zurückgegeben wurde.
Beispiele
Verwenden von next()
Das folgende Beispiel zeigt einen Generator und das Objekt, das die next-Methode zurückgibt:
// An async task. Pretend it's doing something more useful
// in practice.
function delayedValue(time, value) {
return new Promise((resolve, reject) => {
setTimeout(() => resolve(value), time);
});
}
async function* createAsyncGenerator() {
yield delayedValue(500, 1);
yield delayedValue(500, 2);
yield delayedValue(500, 3);
}
const asyncGen = createAsyncGenerator();
asyncGen.next().then((res) => console.log(res)); // { value: 1, done: false }
asyncGen.next().then((res) => console.log(res)); // { value: 2, done: false }
asyncGen.next().then((res) => console.log(res)); // { value: 3, done: false }
asyncGen.next().then((res) => console.log(res)); // { value: undefined, done: true }
Werte an den Generator senden
In diesem Beispiel wird next mit einem Wert aufgerufen.
Hinweis: Der erste Aufruf protokolliert nichts, da der Generator zunächst nichts "yielded".
// An async task. Pretend it's doing something more useful
// in practice.
function sleep(time) {
return new Promise((resolve, reject) => {
setTimeout(resolve, time);
});
}
async function* createAsyncGenerator() {
while (true) {
await sleep(500);
const value = yield;
console.log(value);
}
}
async function main() {
const asyncGen = createAsyncGenerator();
// No log at this step: the first value sent through `next` is lost
console.log(await asyncGen.next(1)); // { value: undefined, done: false }
// Logs 2: the value sent through `next`
console.log(await asyncGen.next(2)); // { value: undefined, done: false }
}
main();
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-asyncgenerator-prototype-next |
Browser-Kompatibilität
Loading…
Siehe auch
async function*- Iteratoren und Generatoren Leitfaden