Возврат значения

Вызов функции — это выражение, и у него есть значение. Какое именно — решает return: что стоит после него, то и окажется на месте вызова.

function sum(a, b) {
  return a + b;
}

console.log(sum(2, 3));

Раз вызов — это значение, с ним можно делать всё то же самое, что с обычным числом или строкой: складывать, сравнивать, класть в переменную, передавать в другую функцию.

function double(n) {
  return n * 2;
}

const total = double(5) + double(10);
console.log(total);

Если функция ничего не вернула явно, вызов всё равно даёт значение — undefined. Так происходит и когда return в функции нет вовсе, и когда он написан голым, без значения.

function greet(name) {
  console.log("Привет, " + name + "!");
}

const result = greet("Аня");
console.log(result);

console.log показывает значение человеку, return отдаёт его программе. Это разные вещи: функция может напечатать хоть роман и всё равно вернуть undefined.

Голый return; пишут, когда результат не нужен, а нужно просто выйти из функции пораньше.

function checkAge(age) {
  if (age < 18) return;
  return "доступ разрешён";
}

console.log(checkAge(15));
console.log(checkAge(30));

return не просто отдаёт значение — он мгновенно прекращает работу функции. Строки после него не выполнятся никогда, даже если их десять.

function test() {
  console.log("до return");
  return "готово";
  console.log("после return");
}

console.log(test());

Поэтому return в функции может быть сколько угодно: сработает тот, до которого выполнение дойдёт первым, остальные останутся не у дел.

Приём, когда особые случаи отсекают в начале функции отдельными return, называют ранним возвратом. Сначала разбираемся со странными входными данными, а дальше пишем главный случай — уже спокойно и без вложенности.

function priceWithDiscount(price, code) {
  if (price <= 0) return 0;
  if (code !== "SALE") return price;
  return price * 0.9;
}

console.log(priceWithDiscount(200, "SALE"));
console.log(priceWithDiscount(200, "XXX"));

Ту же логику можно собрать на if ... else — и тогда основная ветка уедет вправо на пару уровней отступа. Ранний возврат держит код плоским: главное видно сразу, а условия читаются как список исключений.

Вернуть можно что угодно: число, строку, массив, объект, даже другую функцию. Если результатов несколько, не выдумывайте пару функций — упакуйте всё в один объект.

function makeUser(name, age) {
  return { name, age };
}

const user = makeUser("Ника", 20);
console.log(user.name);

У стрелочных функций короткая форма возвращает значение сама, без слова return. Но объект в ней приходится оборачивать в круглые скобки — иначе фигурные скобки будут поняты как тело функции, а не как объект. Саму запись разбирает статья «Стрелочные функции»; здесь она встречается только как ещё один способ вернуть значение.

const point = (x, y) => ({ x, y });

console.log(point(1, 2).y);

function multiplier(k) {
  return (n) => n * k;
}

const triple = multiplier(3);
console.log(triple(7));

JavaScript умеет расставлять точки с запятой сам, и после return делает это особенно охотно. Перенос строки сразу за словом return обрывает его: функция возвращает undefined, а значение снизу остаётся недостижимым. Ошибки при этом не будет — код просто тихо работает не так.

function getName() {
  return
    "Мария";
}

console.log(getName());

Лечится это тем, что значение начинается на той же строке. Если выражение длинное и в одну строку не помещается, откройте круглую скобку сразу после return — тогда движок видит, что предложение ещё не закончилось.

function getName() {
  return (
    "Мария"
  );
}
console.log(getName());