CKTIS / HTML
onbeforeunload — obrada događaja prije napuštanja stranice
Atribut onbeforeunload na body postavlja rukovatelj za događaj beforeunload objekta Window. Može zatražiti upozorenje prije napuštanja stranice, ali ne jamči prikaz dijaloškog okvira ni otkazivanje navigacije.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onbeforeunload="event.preventDefault()">onbeforeunload je atribut rukovatelja događajem na body. Njegova je vrijednost JavaScript kod, a ne naziv događaja ili logička vrijednost. Rukuje događajem beforeunload objekta Window, a ne događajem usmjerenim na sam body. Odgovarajuće svojstvo JavaScripta jest window.onbeforeunload.
Pri stvarnom napuštanju stranice rukovatelj može pozvati event.preventDefault() da zatraži potvrdu. Zastarjeli mehanizam postavlja event.returnValue na neprazan niz. Posebno pravilo za onbeforeunload dopušta i vraćanje vrijednosti koja nije null ni undefined radi otkazivanja događaja; nemojte ovdje primjenjivati uobičajeni obrazac return false. Povratna vrijednost funkcije proslijeđene u addEventListener() ne funkcionira na taj način.
Otkazivanje događaja ne jamči zaustavljanje navigacije: preglednik odlučuje hoće li prikazati potvrdu, a korisnik može odabrati odlazak. Dijaloški okvir zahtijeva prethodnu aktivaciju korisnika, a preglednik ga može potisnuti zbog svojih ograničenja. Vlastiti tekst upozorenja ne može se postaviti. Rukovatelj uključite samo kad postoje nespremljene promjene i uklonite ga nakon spremanja; nemojte ga smatrati zajamčenim mehanizmom za spremanje podataka.
Primjer šalje sintetički događaj koji se može otkazati objektu window i provjerava event.defaultPrevented. Očekivani je rezultat true. Ne testira stvarnu navigaciju ni dijaloški okvir; zatim uklanja atribut kako ne bi ostao aktivan rukovatelj.
Primjeri
<!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>Rezultat
true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.