return

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die return-Anweisung beendet die Ausführung einer Funktion und gibt einen Wert an den Funktionsaufrufer zurück.

Probieren Sie es aus

Syntax

js
return;
return expression;
expression Optional

Der Ausdruck, dessen Wert zurückgegeben werden soll. Wenn weggelassen, wird undefined zurückgegeben.

Beschreibung

Die return-Anweisung kann nur innerhalb von Funktionskörpern verwendet werden. Wenn eine return-Anweisung im Funktionskörper verwendet wird, wird die Ausführung der Funktion gestoppt. Die return-Anweisung hat unterschiedliche Effekte, je nachdem, in welcher Funktion sie platziert ist:

  • In einer normalen Funktion wird der Funktionsaufruf mit dem Rückgabewert ausgewertet.
  • In einer asynchronen Funktion wird das erzeugte Promise mit dem zurückgegebenen Wert aufgelöst.
  • In einer Generatorfunktion gibt die next()-Methode des erzeugten Generatorobjekts { done: true, value: returnedValue } zurück.
  • In einer asynchronen Generatorfunktion wird ein Promise mit { done: true, value: returnedValue } zurückgegeben, das vom erzeugten asynchronen Generatorobjekt erfüllt wird.

Wird eine return-Anweisung innerhalb eines try-Blocks ausgeführt, so wird zunächst dessen finally-Block, falls vorhanden, ausgeführt, bevor der Wert tatsächlich zurückgegeben wird.

Automatische Semikolonsetzung

Die Syntax verbietet Zeilenumbrüche zwischen dem return-Schlüsselwort und dem Ausdruck, der zurückgegeben werden soll.

js
return
a + b;

Der obige Code wird durch die automatische Semikolonsetzung (ASI) in Folgendes umgewandelt:

js
return;
a + b;

Dies führt dazu, dass die Funktion undefined zurückgibt und der Ausdruck a + b nie ausgewertet wird. Dies kann eine Warnung in der Konsole erzeugen.

Um dieses Problem zu vermeiden (um ASI zu verhindern), könnten Sie Klammern verwenden:

js
return (
  a + b
);

Beispiele

Funktion unterbrechen

Eine Funktion stoppt sofort an der Stelle, an der return aufgerufen wird.

js
function counter() {
  // Infinite loop
  for (let count = 1; ; count++) {
    console.log(`${count}A`); // Until 5
    if (count === 5) {
      return;
    }
    console.log(`${count}B`); // Until 4
  }
  console.log(`${count}C`); // Never appears
}

counter();

// Logs:
// 1A
// 1B
// 2A
// 2B
// 3A
// 3B
// 4A
// 4B
// 5A

Eine Funktion zurückgeben

Siehe auch den Artikel über Closures.

js
function magic() {
  return function calc(x) {
    return x * 42;
  };
}

const answer = magic();
answer(1337); // 56154

Spezifikationen

Specification
ECMAScript Language Specification
# sec-return-statement

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch