大网数据广告活动
Web 标准与前端开发

return

· 52CE 我爱测

`expression` - : 待返回其值的表达式。如果省略,则返回 `undefined`。

return 语句用于终止函数执行,并指定要返回给调用函数的值。

JavaScript Demo: Statement - Return

function getRectArea(width, height) {
  if (width > 0 && height > 0) {
    return width * height;
  }
  return 0;
}

console.log(getRectArea(3, 4));
// Expected output: 12

console.log(getRectArea(-3, 4));
// Expected output: 0

语法

return;
return expression;
  • expression
    • : 待返回其值的表达式。如果省略,则返回 undefined。

描述

return 语句只能在函数体内使用。当 return 出现在函数体内部时,该函数的执行将会停止。return 语句在不同类型的函数中具有不同的效果:

  • 在普通函数中,对该函数的调用会返回其返回值。
  • 在异步函数中,生成的 promise 将以返回的值敲定。
  • 在生成器函数中,生成的生成器对象的 next() 方法将返回 { done: true, value: 返回的值 }。
  • 在异步生成器函数中,生成的异步生成器对象的 next() 方法返回一个已兑现的 promise,其值为 { done: true, value: 返回的值 }。

如果在 Statements/try...catch 块内执行了 return 语句,它会首先执行 finally 块然后才实际返回值(如果存在)。

自动分号补全

语法禁止在 return 关键字和要返回的表达式之间使用换行符。

return
a + b;

上述代码会被自动分号补全(ASI)转换为:

return;
a + b;

这会使函数返回 undefined,而 a + b 表达式永远不会被计算。这可能会在控制台中生成警告。

为避免此问题(防止 ASI),你可以使用括号:

return (
  a + b
);

示例

中断函数

函数在调用 return 时立即停止执行。

function counter() {
  // 无限循环
  for (let 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() {
  return function calc(x) {
    return x * 42;
  };
}

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

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。