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

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

コンストラクター

PromiseRejectionEvent()

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

インスタンスプロパティ

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

PromiseRejectionEvent.promise読取専用

拒否された JavaScript のPromise です。

PromiseRejectionEvent.reason読取専用

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

インスタンスメソッド

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

イベント

rejectionhandled

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

unhandledrejection

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

例

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

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

仕様書

ブラウザーの互換性

関連情報

• プロミスの使用
• Promise
• rejectionhandled
• unhandledrejection