Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onbeforeunload — obsługa zdarzenia przed opuszczeniem strony

Atrybut onbeforeunload elementu body ustawia procedurę obsługi zdarzenia beforeunload obiektu Window. Może żądać ostrzeżenia przed opuszczeniem strony, ale nie gwarantuje wyświetlenia dialogu ani zatrzymania nawigacji.

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

Składnia

<body onbeforeunload="event.preventDefault()">

onbeforeunload jest atrybutem obsługi zdarzenia na elemencie body. Jego wartością jest kod JavaScript, a nie nazwa zdarzenia ani wartość logiczna. Obsługuje zdarzenie beforeunload obiektu Window, nie samego elementu body. Odpowiadająca mu właściwość JavaScript to window.onbeforeunload.

Podczas rzeczywistego opuszczania strony procedura może wywołać event.preventDefault(), aby zażądać potwierdzenia. Historyczny mechanizm polega na ustawieniu event.returnValue na niepusty tekst. Specjalna reguła dla onbeforeunload pozwala też zwrócić wartość inną niż null i undefined, aby anulować zdarzenie; nie należy przenosić tu typowego wzorca return false. Wartość zwracana przez funkcję przekazaną do addEventListener() nie działa w ten sposób.

Anulowanie zdarzenia nie gwarantuje zatrzymania nawigacji: przeglądarka decyduje o wyświetleniu potwierdzenia, a użytkownik może wybrać opuszczenie strony. Dialog wymaga wcześniejszej aktywacji przez użytkownika i może zostać pominięty ze względu na ograniczenia przeglądarki. Nie można ustawić własnej treści ostrzeżenia. Włączaj obsługę tylko przy niezapisanych zmianach i usuwaj ją po zapisie; nie traktuj jej jako gwarantowanego mechanizmu zapisywania danych.

Przykład wysyła syntetyczne, anulowalne zdarzenie do window i sprawdza event.defaultPrevented. Oczekiwany wynik to true. Nie testuje rzeczywistej nawigacji ani dialogu; następnie usuwa atrybut, aby nie pozostawić aktywnej procedury.

Przykłady

<!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>

Wynik

true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła