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 (en-US) 作為 reason 是很有幫助的。

範例

使用靜態方法 Promise.reject()

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

規範

Specification
ECMAScript Language Specification
# sec-promise.reject

瀏覽器相容性

BCD tables only load in the browser

參見