CKTIS / HTML
onbeforeunload — obravnava dogodka pred zapustitvijo strani
Atribut onbeforeunload na body nastavi obravnavo dogodka beforeunload objekta Window. Pred zapustitvijo strani lahko zahteva opozorilo, vendar ne zagotavlja prikaza pogovornega okna ali preklica navigacije.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<body onbeforeunload="event.preventDefault()">onbeforeunload je atribut za obravnavo dogodka na body. Njegova vrednost je koda JavaScript, ne ime dogodka ali logična vrednost. Obravnava dogodek beforeunload objekta Window, ne dogodka, usmerjenega na sam body. Ustrezna lastnost JavaScript je window.onbeforeunload.
Pri dejanskem zapuščanju strani lahko obravnavalnik pokliče event.preventDefault() in zahteva potrditev. Starejši mehanizem nastavi event.returnValue na neprazen niz. Posebno pravilo za onbeforeunload dovoljuje tudi vrnitev vrednosti, ki ni null ali undefined, s čimer se dogodek prekliče; sem ne prenašajte običajnega vzorca return false. Vrnjena vrednost funkcije, posredovane v addEventListener(), ne deluje tako.
Preklic dogodka ne zagotavlja, da se bo navigacija ustavila: brskalnik odloči, ali bo prikazal potrditev, uporabnik pa se lahko odloči za odhod. Pogovorno okno zahteva predhodno aktivacijo uporabnika, brskalnik pa ga lahko zaradi svojih omejitev skrije. Besedila opozorila po meri ni mogoče nastaviti. Obravnavo vklopite samo ob neshranjenih spremembah in jo po shranjevanju odstranite; ne obravnavajte je kot zagotovljen mehanizem za shranjevanje podatkov.
Primer na window pošlje sintetičen dogodek, ki ga je mogoče preklicati, in preveri event.defaultPrevented. Pričakovani izpis je true. Ne preizkuša dejanske navigacije ali pogovornega okna; nato odstrani atribut, da ne ostane aktiven obravnavalnik.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.