PromiseRejectionEvent

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

プロミス拒否イベントについての詳細は、プロミスの拒否イベントを参照してください。

Event PromiseRejectionEvent

コンストラクター

PromiseRejectionEvent()

PromiseRejectionEvent イベントを、指定されたイベントの種類(unhandledrejection または rejectionhandled)およびその他の詳細を指定して作成します。

インスタンスプロパティ

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

PromiseRejectionEvent.promise 読取専用

拒否された JavaScript の Promise です。

PromiseRejectionEvent.reason 読取専用

値、または Object で、 Promise.reject() に渡されたプロミスが拒否された理由を示します。

インスタンスメソッド

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

イベント

rejectionhandled

JavaScript の Promise が拒否され、そのプロミスの拒否ハンドラーのコードが実行された後に発生します。

unhandledrejection

JavaScript の Promise が拒否されが、その拒否を処理する拒否ハンドラーがない場合に発生します。

この単純な例は、処理されなかったプロミスの拒否を捕捉し、デバッグのためにログ出力します。

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

仕様書

Specification
HTML
# the-promiserejectionevent-interface

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
PromiseRejectionEvent
PromiseRejectionEvent() constructor
promise
reason

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

関連情報