AsyncGenerator.prototype.next()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.

Die next()-Methode von AsyncGenerator-Instanzen gibt den nächsten Wert in der Sequenz zurück.

In diesem Artikel

Syntax

js
next()
next(value)

Parameter

value Optional

Ein optionaler Wert, der verwendet wird, um den internen Zustand des Generators zu ändern. Ein an die next()-Methode übergebener Wert wird von yield empfangen.

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 gibt value den 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:

js
// 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".

js
// 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

Spezifikation

ECMAScript® 2027 Language Specification
# sec-asyncgenerator-prototype-next

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch

async function*
Iteratoren und Generatoren Leitfaden

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
AsyncGenerator
Instanzmethoden
1. next()
2. return()
3. throw()
Vererbung
AsyncIterator
Instanzmethoden
1. [Symbol.asyncDispose]()
2. [Symbol.asyncIterator]()
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor