Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła