WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onpagehide — das Verlassen einer Seite behandeln

Das Attribut onpagehide auf body registriert einen Handler für das pagehide-Ereignis des Window-Objekts. Bei einem vom Browser erzeugten Ereignis zeigt event.persisted mit dem Wert true an, dass der Browser das Dokument zur möglichen Wiederverwendung behalten will, nicht dass er es tatsächlich behält.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<body onpagehide="JavaScript statements">

onpagehide ist ein Event-Handler-Attribut für pagehide. Wird es auf body verwendet, behandelt es das Ereignis auf Window und nicht ein Ereignis, das auf dieses Element beschränkt ist. Es ist kein globales Attribut, das auf beliebigen Elementen verfügbar ist. Der Standard stellt es auch auf dem veralteten Element frameset bereit. Der Attributwert enthält JavaScript-Anweisungen; das Ereignisobjekt ist als event verfügbar.

Das Ereignis pagehide betrifft das Verlassen einer Seite, nicht lediglich den Wechsel zwischen Tabs. Bei einem vom Browser erzeugten Ereignis hat die Eigenschaft persisted des Objekts PageTransitionEvent den Wert false, wenn das Dokument endgültig verlassen wird, und true, wenn der Browser beabsichtigt, es zur möglichen Wiederverwendung zu behalten, etwa im Back/Forward-Cache (bfcache). Der Wert true garantiert weder, dass das Dokument tatsächlich aufbewahrt wird, noch dass es später wiederhergestellt wird.

Das JavaScript-Gegenstück ist window.onpagehide = handler; die Zuweisung ersetzt den vorherigen Handler dieser Eigenschaft. Mit window.addEventListener('pagehide', handler) lassen sich unabhängige Listener registrieren. Das Beispiel löst ein synthetisches Ereignis aus, damit die Ausgabe reproduzierbar ist: Es verlässt weder die Seite noch legt es sie im bfcache ab.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onpagehide demo</title>
<body onpagehide="document.getElementById('result').textContent = event.type + ': persisted=' + event.persisted">
  <output id="result">Waiting</output>
  <script>
    window.dispatchEvent(new PageTransitionEvent('pagehide', {
      persisted: true
    }));
  </script>
</body>
</html>

Ergebnis

pagehide: persisted=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.

Quellen