PromiseRejectionEvent

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

	デスクトップ						モバイル
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Android 版 Chrome	Android 版 Firefox	Android 版 Opera	iOSのSafari	Samsung Internet
`PromiseRejectionEvent`	Chrome 完全対応 49	Edge ?	Firefox 完全対応 69 完全対応 69 完全対応 68 無効無効 From version 68: 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 完全対応 36	Safari 完全対応 11	WebView Android 完全対応 49	Chrome Android 完全対応 49	Firefox Android 完全対応 68 無効完全対応 68 無効無効 From version 68: 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 完全対応 36	Safari iOS 完全対応 11.3	Samsung Internet Android 完全対応 5.0
`PromiseRejectionEvent()` constructor	Chrome 完全対応 49	Edge ?	Firefox 完全対応 69 完全対応 69 完全対応 68 無効無効 From version 68: 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 完全対応 36	Safari 完全対応 11	WebView Android 完全対応 49	Chrome Android 完全対応 49	Firefox Android 完全対応 68 無効完全対応 68 無効無効 From version 68: 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 完全対応 36	Safari iOS 完全対応 11.3	Samsung Internet Android 完全対応 5.0
`promise`	Chrome 完全対応 49	Edge ?	Firefox 完全対応 69 完全対応 69 完全対応 68 無効無効 From version 68: 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 完全対応 36	Safari 完全対応 11	WebView Android 完全対応 49	Chrome Android 完全対応 49	Firefox Android 完全対応 68 無効完全対応 68 無効無効 From version 68: 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 完全対応 36	Safari iOS 完全対応 11.3	Samsung Internet Android 完全対応 5.0
`reason`	Chrome 完全対応 49	Edge ?	Firefox 完全対応 69 完全対応 69 完全対応 68 無効無効 From version 68: 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 完全対応 36	Safari 完全対応 11	WebView Android 完全対応 49	Chrome Android 完全対応 49	Firefox Android 完全対応 68 無効完全対応 68 無効無効 From version 68: 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 完全対応 36	Safari iOS 完全対応 11.3	Samsung Internet Android 完全対応 5.0

凡例

完全対応: 完全対応
未対応: 未対応
実装状況不明: 実装状況不明
ユーザーが明示的にこの機能を有効にしなければなりません。: ユーザーが明示的にこの機能を有効にしなければなりません。