WorkerGlobalScope: unhandledrejection イベント

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年7月以降、すべてのブラウザーで利用可能です。

unhandledrejection イベントは、スクリプトのグローバルスコープ（通常は WorkerGlobalScope）に送られるものであり、拒否ハンドラーのない Promise が拒否されたときに発行されます。

これはデバッグや、予期せぬ状況でのフォールバックエラー処理を提供するのに有益です。

構文

このイベント名を addEventListener() などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

self.addEventListener("unhandledrejection", (event) => {});
self.onunhandledrejection = (event) => {};

イベント型

PromiseRejectionEvent です。 Event から継承しています。

イベントプロパティ

PromiseRejectionEvent.promise 読取専用: 拒否されたプロミス (Promise) です。
PromiseRejectionEvent.reason 読取専用: プロミスが拒否された理由を示す値または Object で、Promise.reject() に渡されたものです。

例

基本的なエラーログ出力

この例は、未処理のプロミスの拒否に関する情報をコンソールにログ出力します。

self.addEventListener("unhandledrejection", (event) => {
  console.warn(`UNHANDLED PROMISE REJECTION: ${event.reason}`);
});

また、onunhandledrejection イベントハンドラープロパティを使用して、イベントリスナーを設定することができます。

self.onunhandledrejection = (event) => {
  console.warn(`UNHANDLED PROMISE REJECTION: ${event.reason}`);
};

多くの環境（Node.js など）では、既定では処理されなかったプロミスの拒否をコンソールに報告します。unhandledrejection イベントのハンドラーを追加することで、そこでイベントをキャンセルする preventDefault() を呼び出すことで、ランタイムのログ出力コードで処理されるのを防ぐことができます。これは unhandledrejection がキャンセル可能であるため、うまく動作します。

self.addEventListener("unhandledrejection", (event) => {
  // code for handling the unhandled rejection
  // …

  // Prevent the default handling (such as outputting the
  // error to the console)

  event.preventDefault();
});