CKTIS / HTML
onunload — das Entladen eines Dokuments behandeln
Das onunload-Attribut des body-Elements legt einen Handler für das unload-Ereignis des Window-Objekts fest, nicht für das Element selbst. Es ist weder ein zuverlässiger Ort zum Speichern von Daten noch eine Möglichkeit, das Verlassen einer Seite zu verhindern.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onunload="/* JavaScript */">
window.onunload = handler;
window.onunload = null;onunload ist ein Event-Handler-Content-Attribut für unload. Beim body-Element enthält sein Wert JavaScript, das als Handler des zugehörigen Window-Objekts ausgeführt wird. Es ist kein gewöhnliches globales Attribut für beliebige HTML-Elemente.
Das JavaScript-Gegenstück ist window.onunload, dem eine Funktion oder null zugewiesen werden kann. Das body-Attribut und diese Eigenschaft steuern denselben Handler: Eine weitere Zuweisung ersetzt den bisherigen Wert, und null entfernt ihn. Im Code des Attributs stellt der Parameter event das Ereignis bereit.
unload betrifft das Entladen eines Dokuments. Gehe jedoch nicht davon aus, dass es bei jedem Verlassen einer Seite ausgelöst wird. Der Algorithmus des Standards überspringt es, wenn das Dokument zur späteren Wiederherstellung aus dem Verlauf aufbewahrt wird. Verwende es nicht als einzigen Ort zum Speichern wichtiger Daten und verlasse dich nicht darauf, dass dort asynchrone Arbeit abgeschlossen wird. Für die Beobachtung des Lebenszyklus kommen je nach Zweck pagehide oder visibilitychange infrage.
Verwechsle onunload nicht mit onbeforeunload: unload kann nicht abgebrochen werden, und return false hält weder die Navigation auf noch zeigt es eine Nachfrage zum Verlassen der Seite an. Das Beispiel löst absichtlich ein synthetisches Ereignis aus, um die Verbindung des Attributs mit Window zu zeigen, ohne die Seite zu schließen; es bildet kein tatsächliches Entladen des Dokuments nach.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onunload demonstration</title>
<body onunload="document.getElementById('result').textContent = event.type">
<output id="result">pending</output>
<script>
window.dispatchEvent(new Event('unload'));
window.onunload = null;
</script>
</body>
</html>Ergebnis
unload
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.