CKTIS / HTML
onbeforeunload — ein Ereignis vor dem Verlassen einer Seite behandeln
Das Attribut onbeforeunload auf body legt einen Handler für das beforeunload-Ereignis des Window-Objekts fest. Es kann vor dem Verlassen der Seite eine Warnung anfordern, garantiert aber weder einen Dialog noch den Abbruch der Navigation.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onbeforeunload="event.preventDefault()">onbeforeunload ist ein Ereignis-Handler-Attribut auf body. Sein Wert ist JavaScript-Code, kein Ereignisname und kein boolescher Wert. Es behandelt das beforeunload-Ereignis des Window-Objekts, nicht ein Ereignis, das sich an body selbst richtet. Die entsprechende JavaScript-Eigenschaft ist window.onbeforeunload.
Beim tatsächlichen Verlassen einer Seite kann der Handler event.preventDefault() aufrufen, um eine Bestätigung anzufordern. Ein älterer Mechanismus setzt event.returnValue auf eine nicht leere Zeichenfolge. Eine Sonderregel für onbeforeunload erlaubt außerdem, einen Wert ungleich null und undefined zurückzugeben, um das Ereignis abzubrechen; übertrage das übliche Muster return false nicht hierher. Der Rückgabewert einer an addEventListener() übergebenen Funktion funktioniert nicht auf diese Weise.
Das Abbrechen des Ereignisses garantiert nicht, dass die Navigation angehalten wird: Der Browser entscheidet, ob eine Bestätigung angezeigt wird, und der Nutzer kann sich für das Verlassen entscheiden. Ein Dialog erfordert eine vorherige Nutzeraktivierung und kann aufgrund von Browserbeschränkungen unterdrückt werden. Eigener Warntext lässt sich nicht festlegen. Aktiviere den Handler nur bei ungespeicherten Änderungen und entferne ihn nach dem Speichern; betrachte ihn nicht als garantierten Mechanismus zum Speichern von Daten.
Das Beispiel löst ein synthetisches, abbrechbares Ereignis auf window aus und prüft event.defaultPrevented. Die erwartete Ausgabe ist true. Es testet weder eine echte Navigation noch einen Dialog und entfernt anschließend das Attribut, damit kein aktiver Handler zurückbleibt.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>onbeforeunload wiring test</title>
</head>
<body onbeforeunload="event.preventDefault()">
<p>See the browser console.</p>
<script>
const event = new Event('beforeunload', { cancelable: true });
window.dispatchEvent(event);
console.log(event.defaultPrevented);
document.body.removeAttribute('onbeforeunload');
</script>
</body>
</html>Ergebnis
true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.