WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

return — eine Funktion beenden und einen Wert zurückgeben

Die return-Anweisung beendet die Ausführung einer Funktion und kann ein Ergebnis an die aufrufende Stelle zurückgeben. Erfahre mehr über return ohne Ausdruck, vorzeitiges Beenden und die Falle eines Zeilenumbruchs.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

return;
return expression;

return ist ein reserviertes Schlüsselwort. In einer gewöhnlichen Funktion wertet return expression; den Ausdruck aus und gibt dessen Wert an die aufrufende Stelle zurück. return; gibt undefined zurück; dasselbe Ergebnis entsteht, wenn eine gewöhnliche Funktion ohne return bis zu ihrem Ende ausgeführt wird. Auf der obersten Ebene eines standardmäßigen Skripts oder Moduls ist die Anweisung nicht zulässig.

Verwende ein vorzeitiges return, um eine Funktion nach einer Bedingungsprüfung zu beenden. Es beendet die gesamte aktuelle Funktion, nicht nur eine umschließende Schleife. Im Beispiel wird doublePositive(0) vor der Multiplikation beendet, während doublePositive(3) den Wert 6 zurückgibt.

Setze keinen Zeilenumbruch zwischen return und den zurückzugebenden Ausdruck. Die automatische Semikolon-Einfügung kann die Anweisung dann als return; beenden. Beginne einen mehrzeiligen Ausdruck beispielsweise mit return ( und setze ihn in den folgenden Zeilen fort.

Ein finally-Block wird ausgeführt, bevor eine ausstehende Rückgabe abgeschlossen ist. Ein eigenes return oder throw darin kann dieses Ergebnis ersetzen; vermeide daher solche Überschreibungen. return ist ECMAScript-Syntax und keine Web-API; das Beispiel benötigt keine Browser-API.

Beispiele

function doublePositive(value) {
  if (value <= 0) return;
  return value * 2;
}

console.log(doublePositive(3));
console.log(doublePositive(0));

Ergebnis

6
undefined

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen