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 Standard
# the-promiserejectionevent-interface

ブラウザーの互換性

BCD tables only load in the browser

関連情報