onbeforeunload イベントは、文書がまさにアンロードされようとしている時に発火します。
このイベントは、現在のページに留まりたいか、出て行きたいかを、 ユーザに通知するための確証ダイアログボックスでメッセージを表示することができるようにします。
確認ボックスに表示されるデフォルトのメッセージは、ブラウザ毎に異なります。 しかし、標準的なメッセージは「本当に、このページから出て行きますか?」のようなものです。このメッセージを削除することはできません。
ただし、デフォルトのメッセージと一緒にカスタムメッセージを書くことができます。このページの最初の例を参照してください。
注: Firefox では、デフォルト・メッセージだけが表示されます(カスタムメッセージは(もしあれば)表示されません)。
onbeforeunload 属性は イベント属性 の一つで、次の要素で使用することができます:
要素 | イベント |
---|---|
<body> | onbeforeunload |
ページがアンロードされようとしている時に JavaScript を実行します:
<body onbeforeunload="return myFunction()">
Try it Yourself ❯
表中の数字は、イベントを完全にサポートした最初のブラウザ・バージョンを指定しています。
イベント属性 | |||||
---|---|---|---|---|---|
onbeforeunload | Yes | Yes | Yes | Yes | 15.0 |