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 Status Comment
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Promise.reject' in that specification.
Standard Initial definition in an ECMA standard.
ECMAScript (ECMA-262)
The definition of 'Promise.reject' in that specification.
Living Standard  

Browser compatibility

BCD tables only load in the browser

See also