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
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.
return
a + b;
Der obige Code wird durch die automatische Semikolonsetzung (ASI) in Folgendes umgewandelt:
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:
return (
a + b
);
Beispiele
Funktion unterbrechen
Eine Funktion stoppt sofort an der Stelle, an der return
aufgerufen wird.
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.
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