AsyncGenerator.prototype.return()

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 return()-Methode von AsyncGenerator-Instanzen wirkt so, als ob eine return-Anweisung an der aktuellen Stelle des angehaltenen Generator-Körpers eingesetzt wird. Dies beendet den Generator und ermöglicht es diesem, alle Aufräumarbeiten durchzuführen, wenn er mit einem try...finally-Block kombiniert wird.

In diesem Artikel

Syntax

js
asyncGeneratorInstance.return()
asyncGeneratorInstance.return(value)

Parameter

value Optional

Der zurückzugebende Wert.

Rückgabewert

Ein Promise, das mit einem Object aufgelöst wird, das zwei Eigenschaften hat:

done

Ein boolescher Wert:

true, wenn der Kontrollfluss der Generatorfunktion das Ende erreicht hat.
false, wenn der Kontrollfluss der Generatorfunktion das Ende nicht erreicht hat und noch mehr Werte erzeugen kann. Dies kann nur passieren, wenn das return in einem try...finally eingefangen wird und es mehr yield-Ausdrücke im finally-Block gibt.

value

Der Wert, der als Argument übergeben wird, oder, wenn der yield-Ausdruck in einem try...finally eingeschlossen ist, der aus dem finally-Block zurückgegebene/geyieldete Wert.

Beschreibung

Die return()-Methode kann, wenn sie aufgerufen wird, so betrachtet werden, als ob eine return value;-Anweisung an der aktuellen Stelle des angehaltenen Generator-Körpers eingefügt wird, wobei value der Wert ist, der an die return()-Methode übergeben wird. Daher wird normalerweise beim Aufruf von return(value) { done: true, value: value } zurückgegeben. Ist der yield-Ausdruck jedoch in einem try...finally-Block eingeschlossen, verlässt der Kontrollfluss den Funktionskörper nicht sofort, sondern fährt mit dem finally-Block fort. In diesem Fall kann der zurückgegebene Wert unterschiedlich sein, und done kann sogar false sein, wenn es noch mehr yield-Ausdrücke innerhalb des finally-Blocks gibt.

Beispiele

Verwendung von return()

Das folgende Beispiel zeigt einen asynchronen Generator und die Verwendung der return-Methode.

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.return("foo").then((res) => console.log(res)); // { value: "foo", done: true }
asyncGen.next().then((res) => console.log(res)); // { value: undefined, done: true }

Verwendung von return() nachdem ein Generator abgeschlossen ist

Wenn kein value-Argument an die return()-Methode übergeben wird, wird das Promise aufgelöst, als ob die next()-Methode aufgerufen wurde. In diesem Beispiel ist der Generator abgeschlossen, sodass der zurückgegebene Wert undefined ist.

return() kann weiterhin aufgerufen werden, nachdem der Generator in einem "abgeschlossenen" Zustand ist, allerdings bleibt der Generator in diesem Zustand.

js
async function* createAsyncGenerator() {
  yield Promise.resolve(1);
  yield await Promise.resolve(2);
  yield 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 }
// value is returned undefined, as no value is passed and generator is 'done'
asyncGen.return().then((res) => console.log(res)); // { value: undefined, done: true }
// we can still return a value once the generator is complete
asyncGen.return(1).then((res) => console.log(res)); // { value: 1, done: true }

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