PromiseRejectionEvent()
PromiseRejectionEvent()
コンストラクターは、新しい PromiseRejectionEvent
オブジェクトを返します。これは、 JavaScript の Promise
が拒否されたときに発生するイベントを表します。
プロミス拒否イベントにより、失敗したプロミスや、失敗を見逃したプロミスを検出して報告することが可能になります。また、エラーに対するグローバルハンドラーを書くことも容易になります。
PromiseRejectionEvent
には 2 種類あります。 unhandledrejection
は、プロミスが拒否されたが処理されなかった場合に JavaScript ランタイムによって発行されます。 rejectionhandled
イベントは、プロミスが拒否されたが、拒否が拒否ハンドラーによって捕捉された場合に発行されるものです。
構文
js
new PromiseRejectionEvent(type, options)
引数
返値
引数で指定された通りに構成された、新しい PromiseRejectionEvent
オブジェクトです。
例
この例では、文字列 "My house is on fire" を理由とするプロミス myPromise
に対して新しい unhandledrejection
イベントが作成されます。理由`は数字とすることもできますし、家の住所や火事の程度、緊急連絡先の電話番号など、詳細な情報を記載したオブジェクトでも構いません。
js
let myRejectionEvent = new PromiseRejectionEvent("unhandledrejection", {
promise: myPromise,
reason: "My house is on fire",
});
仕様書
Specification |
---|
HTML Standard # unhandled-promise-rejections:dom-event-constructor |
ブラウザーの互換性
BCD tables only load in the browser