Promise.reject()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Promise.reject(reason) 方法回傳一個以 reason 拒絕的 Promise 物件。
語法
js
Promise.reject(reason);
參數
- reason
-
Promise的失敗訊息。
回傳值
一個以 reason 拒絕的 Promise。
描述
靜態函式 Promise.reject 回傳一個被拒絕的 Promise。由於除錯目的及選擇性錯誤捕捉（selective error catching），使用一個 instanceof Error 作為 reason 是很有幫助的。
範例
使用靜態方法 Promise.reject()
js
Promise.reject(new Error("fail")).then(
function (error) {
// not called
},
function (error) {
console.log(error); // Stacktrace
},
);
規範
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-promise.reject |