Promise.reject()

Promise.reject(reason) メソッドは、引数で与えられた理由でリジェクトされた Promise オブジェクトを返します。

構文

Promise.reject(reason);

引数

reason
このPromiseオブジェクトのリジェクトされた理由

返り値

与えられた理由で拒否された Promise 。

説明

静的なPromise.reject 関数はリジェクトされたPromiseを返します。デバッグのためにキャッチするエラーを選別したい場合は、 reasonをinstanceof Errorにかけると良いでしょう。

例

静的な Promise.reject() メソッドを使う

Promise.reject(new Error("fail")).then(function() {
  // ここは呼ばれません。
}, function(error) {
  console.log(error); // Stacktrace
});

仕様

仕様 状況 コメント
ECMAScript 2015 (6th Edition, ECMA-262)
Promise.reject の定義		 標準 Initial definition in an ECMA standard.
ECMAScript (ECMA-262)
Promise.reject の定義		 現行の標準  

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
reject()Chrome 完全対応 32Edge 完全対応 12Firefox 完全対応 29IE 未対応 なしOpera 完全対応 19Safari 完全対応 8WebView Android 完全対応 4.4.3Chrome Android 完全対応 32Firefox Android 完全対応 29Opera Android 完全対応 19Safari iOS 完全対応 8Samsung Internet Android 完全対応 2.0nodejs 完全対応 0.12

凡例

完全対応  
完全対応
未対応  
未対応

関連情報

関連トピック
  1. Standard built-in objects
  2. Promise
  3. メソッド
    1. Promise.all()
    2. Promise.allSettled()
    3. Promise.any() [翻訳する]
    4. Promise.prototype.catch()
    5. Promise.prototype.finally()
    6. Promise.prototype.then()
    7. Promise.race()
    8. Promise.reject()
    9. Promise.resolve()
  4. 継承
  5. Function
  6. プロパティ
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
  7. メソッド
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  8. Object
  9. プロパティ
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__
    3. Object.prototype.__parent__
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  10. メソッド
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch()
    12. Object.prototype.valueOf()
    13. Object.prototype.watch()
    14. Object.setPrototypeOf()