此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。
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 2015年7月.
Promise.reject(reason) 方法回傳一個以reason 拒絕的Promise 物件。
語法
js
Promise.reject(reason);參數
- reason
Promise的失敗訊息。
回傳值
一個以reason 拒絕的Promise。
描述
靜態函式Promise.reject 回傳一個被拒絕的Promise。由於除錯目的及選擇性錯誤捕捉（selective error catching），使用一個instanceofError 作為 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 |