Promise.reject()

Promise.reject(reason) 方法回傳一個以 reason 拒絕的 Promise 物件。

語法

Promise.reject(reason);

參數

reason

Promise 的失敗訊息。

回傳值

一個以 reason 拒絕的 Promise。

描述

靜態函式 Promise.reject 回傳一個被拒絕的 Promise。由於除錯目的及選擇性錯誤捕捉（selective error catching），使用一個 instanceof Error 作為 reason 是很有幫助的。

範例

使用靜態方法 Promise.reject()

Promise.reject(new Error('fail')).then(function(error) {
  // not called
}, function(error) {
  console.log(error); // Stacktrace
});

Specifications

Specification
ECMAScript Language Specification
# sec-promise.reject

Browser compatibility

BCD tables only load in the browser

See also