return

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

return 陳述式會終止函式的執行，並指定要回傳給函式呼叫者的值。

嘗試一下

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

console.log(getRectArea(3, 4));
// 預期輸出：12

console.log(getRectArea(-3, 4));
// 預期輸出：0

語法

js
return;
return expression;

expression 選擇性

要回傳其值的表達式。若省略，則回傳 undefined。

描述

return 陳述式只能在函式主體內使用。當 return 陳述式用在函式主體中時，函式的執行將會停止。return 陳述式放置在不同的函式中會有不同的效果：

在一般函式中，對該函式的呼叫會求值為回傳值。
在 async 函式中，產生的 promise 會以回傳值兌現。
在 generator 函式中，產生的 generator 物件的 next() 方法會回傳 { done: true, value: returnedValue }。
在 async generator 函式中，產生的 async generator 物件的 next() 方法會回傳一個以 { done: true, value: returnedValue } 兌現的 promise。

如果 return 陳述式在 try 區塊內執行，且該區塊有 finally 區塊，則 finally 區塊會先執行，然後才實際回傳該值。

自動分號插入

語法禁止在 return 關鍵字與要回傳的表達式之間出現行終止符。

js
return
a + b;

自動分號插入（ASI）會將上面的程式碼轉換為：

js
return;
a + b;

這會使函式回傳 undefined，且 a + b 表達式永遠不會被求值。這可能會在主控台中產生警告。

為了避免這個問題（防止 ASI），你可以使用括號：

js
return (
  a + b
);

範例

中斷函式

函式會在呼叫 return 的當下立即停止。

js
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

回傳函式

參見關於閉包的文章。

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

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

規範

Specification

ECMAScript® 2027 Language Specification
# sec-return-statement

瀏覽器相容性

Enable JavaScript to view this browser compatibility table.

參見

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2026年1月7日 by MDN contributors.

View this page on GitHub • Report a problem with this content

return

In this article

Help improve MDN