CKTIS / JavaScript
return — zakończenie funkcji i zwrócenie wartości
Instrukcja return kończy wykonywanie funkcji i może przekazać wynik do miejsca wywołania. Poznaj pusty return, wcześniejsze wyjście oraz pułapkę nowego wiersza.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
return;
return expression;return jest zarezerwowanym słowem kluczowym. W zwykłej funkcji instrukcja return expression; oblicza wyrażenie i zwraca jego wartość do miejsca wywołania. return; zwraca undefined; taki sam wynik daje dojście do końca zwykłej funkcji bez return. Instrukcja nie jest dozwolona na najwyższym poziomie standardowego skryptu ani modułu.
Używaj wcześniejszego return do zakończenia funkcji po sprawdzeniu warunku. Kończy on całą bieżącą funkcję, a nie tylko otaczającą pętlę. W przykładzie doublePositive(0) kończy się przed mnożeniem, natomiast doublePositive(3) zwraca 6.
Nie umieszczaj końca wiersza między return a zwracanym wyrażeniem. Automatyczne wstawianie średników może wtedy zakończyć instrukcję jako return;. Wielowierszowe wyrażenie rozpocznij na przykład od return ( i kontynuuj w kolejnych wierszach.
Blok finally wykonuje się przed zakończeniem oczekującego powrotu. Własny return lub throw w finally może zastąpić ten wynik, więc unikaj takiego nadpisywania. return jest składnią ECMAScript, a nie Web API; przykład nie wymaga API przeglądarki.
Przykłady
function doublePositive(value) {
if (value <= 0) return;
return value * 2;
}
console.log(doublePositive(3));
console.log(doublePositive(0));Wynik
6 undefined
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.