PromiseRejectionEvent インターフェイスは、 JavaScript の Promise が拒絶されたときにグローバルスクリプトコンテキストに送信されるイベントを表します。これらのイベントは、測定やデバッグ目的に使用すると特に有益です。

コンストラクター

PromiseRejectionEvent()
指定したパラメータで PromiseRejectionEvent イベントを生成する。

プロパティ

親である Event のプロパティも継承しています。

PromiseRejectionEvent.promise 読取専用
拒絶された JavaScript の Promise
PromiseRejectionEvent.reason 読取専用
Promise.reject() に渡される Promise が拒絶された理由を示す値、または Object

メソッド

このインターフェイスには固有のメソッドはありません。親である Event からメソッドを継承しています。

イベント

rejectionhandled
JavaScript の Promise が拒絶され、promise の reject イベントハンドラーのコードが実行された後に発生する。
unhandledrejection
reject に対するイベントハンドラーがない状態で JavaScript の Promise が拒絶されたときに発生する。

window.onunhandledrejection = function(e) {
  console.log(e.reason);
}

仕様書

仕様書 状態 備考
HTML Living Standard
PromiseRejectionEvent の定義
現行の標準 初回定義

ブラウザーの対応

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeEdge MobileAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
PromiseRejectionEventChrome 完全対応 49Edge ? Firefox 未対応 なし
補足 無効
未対応 なし
補足 無効
補足 Firefox doesn't yet send the unhandledrejection or understand rejectionhandled events. Completing the implementation will be addressed in bug 1362272.
無効 This feature is behind the dom.promise_rejection_events.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 未対応 なしOpera 完全対応 36Safari 完全対応 11WebView Android 完全対応 49Chrome Android 完全対応 49Edge Mobile ? Firefox Android 未対応 なし
補足 無効
未対応 なし
補足 無効
補足 Firefox doesn't yet send the unhandledrejection or understand rejectionhandled events. Completing the implementation will be addressed in bug 1362272.
無効 This feature is behind the dom.promise_rejection_events.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 36Safari iOS 完全対応 11.3Samsung Internet Android 完全対応 あり
PromiseRejectionEvent() constructorChrome 完全対応 49Edge ? Firefox 未対応 なし
無効
未対応 なし
無効
無効 This feature is behind the dom.promise_rejection_events.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 未対応 なしOpera 完全対応 36Safari 完全対応 11WebView Android 完全対応 49Chrome Android 完全対応 49Edge Mobile ? Firefox Android 未対応 なし
無効
未対応 なし
無効
無効 This feature is behind the dom.promise_rejection_events.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 36Safari iOS 完全対応 11.3Samsung Internet Android ?
promiseChrome 完全対応 49Edge ? Firefox 未対応 なし
無効
未対応 なし
無効
無効 This feature is behind the dom.promise_rejection_events.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 未対応 なしOpera 完全対応 36Safari 完全対応 11WebView Android 完全対応 49Chrome Android 完全対応 49Edge Mobile ? Firefox Android 未対応 なし
無効
未対応 なし
無効
無効 This feature is behind the dom.promise_rejection_events.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 36Safari iOS 完全対応 11.3Samsung Internet Android 完全対応 あり
reasonChrome 完全対応 49Edge ? Firefox 未対応 なし
無効
未対応 なし
無効
無効 This feature is behind the dom.promise_rejection_events.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE 未対応 なしOpera 完全対応 36Safari 完全対応 11WebView Android 完全対応 49Chrome Android 完全対応 49Edge Mobile ? Firefox Android 未対応 なし
無効
未対応 なし
無効
無効 This feature is behind the dom.promise_rejection_events.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 36Safari iOS 完全対応 11.3Samsung Internet Android 完全対応 あり

凡例

完全対応  
完全対応
未対応  
未対応
実装状況不明  
実装状況不明
実装ノートを参照してください。
実装ノートを参照してください。
ユーザーが明示的にこの機能を有効にしなければなりません。
ユーザーが明示的にこの機能を有効にしなければなりません。

関連情報

ドキュメントのタグと貢献者

このページの貢献者: mfuji09, mdnwebdocs-bot, YuichiNukiyama
最終更新者: mfuji09,