return

Оператор return завершает выполнение текущей функции и возвращает значение этой функции.

Синтаксис

return [[выражение]]; 

выражение

Возвращаем выражение. Если не указано, то вместо него возвращается undefined.

Описание

При вызове оператора return в функции, выполнение этой функции прекращается. Указанное значение возвращается вызывателю функции. Если не указано, возращается undefined вместо него. Следующие выражения всегда прерывают выполнение функции:

return;
return true;
return false;
return x;
return x + y / 3;

Автоматическая расстановка точек с запятыми

На выражение return влияется автоматическая расстановка точек с запятыми (ASI). Разрыв строки не допускается между ключевым словом return и выражением.

return
a + b;

// трансформируется ASI в

return; 
a + b;

// Консоль предупреждает "unreachable code after return statement".

Примеры

return

Данная функция возвращает квадрат аргумента x, где x - число.

function square(x) {
   return x * x;
}

Прерывании функции

Функция немедленно останавливается в точке, где вызывается return.

function counter() {
  for (var count = 1; ; count++) {  // бесконечный цикл
    console.log(count + "A"); // до 5
      if (count === 5) {          
        return;
      }
      console.log(count + "B");  // до 4
    }
  console.log(count + "C");  // никогда не появляется
}

counter();

// Выводит:
// 1A
// 1B
// 2A
// 2B
// 3A
// 3B
// 4A
// 4B
// 5A

Возвращение функции

Смотрите также статью о замыканиях.

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

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

Спецификации

Поддержка браузерами

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Смотрите также

• Функции и область видимость
• Замыкания