BeforeUnloadEvent

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

BeforeUnloadEvent は beforeunload イベントのインターフェイスです。

beforeunload イベントは、ウィンドウ、文書、そのリソースがアンロードされようとしているときに発生します。

Event の returnValue プロパティに空文字列でない値が代入されると、ダイアログボックスが現れ、ユーザーにページを離れるかどうかの確認を求めます(下記の例を参照)。値が指定されなかった場合、イベントはサイレントで処理されます。実装によっては、フレームまたは埋め込まれたフレームがユーザージェスチャまたはユーザーの操作を受け取った場合にのみ、ダイアログボックスを示すものもあります。詳しくはブラウザーの互換性を参照してください。

メモ: セキュリティ上の理由から、返す文字列の代わりに、ウェブページの制御しない一般的な文字列のみが示されます。

バブリングなし

キャンセル可

対象オブジェクト defaultView

インターフェイス Event

例

window.addEventListener("beforeunload", (event) => {
 event.returnValue = "\\o/";
});
// is equivalent to
window.addEventListener("beforeunload", (event) => {
 event.preventDefault();
});

WebKit 派生ブラウザーは、ダイアログボックスについては仕様に従っていません。ほぼクロスブラウザーで動作する例としては、下記の例のようなものがあります。

window.addEventListener("beforeunload", (e) => {
 const confirmationMessage = "\\o/";
 // Gecko + IE
 (e || window.event).returnValue = confirmationMessage;
 // Safari, Chrome, and other WebKit-derived browsers
 return confirmationMessage;
});