WindowEventHandlers.onbeforeunload

De WindowEventHandlers.onbeforeunload event handler property bevat code welke uitgevoerd wordt wanneer beforeunload is verstuurd. Dit event wordt getriggerd wanneer een venster op het punt staat zijn bronnen te unload. Het document is nog steeds zichtbaar en het event is nog steeds te annuleren.

Syntax

window.onbeforeunload = funcRef

• funcRef is een referentie naar een functie of een functie expressie.
• De functie zou een string waarde aan de returnValue property van het Event object moeten toewijzen de deze zelfde string moeten terugsturen.

Voorbeeld

window.onbeforeunload = function(e) {
  var dialogText = 'Dialog text here';
  e.returnValue = dialogText;
  return dialogText;
};

Nota

Wanneer deze event een andere waarde dan null of  undefined terug stuurt (of de returnValue property instelt), wordt de gebruiker gevraagd om het sluiten van de pagina te bevestigen. In sommige browsers wordt de terug gestuurde waarde van dit event weergegeven in een dialoogvenster. Beginnende met Firefox 4, Chrome 51, Opera 38 en Safari 9.1, wordt er een algemene string, welke niet the beinvloeden is door de webpagina, weergegeven in plaats van de terug gestuurde string. Als voorbeeld, Firefox geeft altijd de string "This page is asking you to confirm that you want to leave - data you have entered may not be saved." weer. Zie bug 588292 and Chrome Platform Status.

Sinds 25 Mei 2011, De HTML5 specificatie stelt dat aanroepen van window.alert(), window.confirm(), en window.prompt() methods mogen worden genegeerd tijdens dit event. Zie de HTML5 specification voor meer details.

Let op dat sommige mobile browsers het resultaat van het event negeren (Ze vragen niet om bevestiging aan de gebruiker). Firefox heeft een verborgen instelling in about:config om ditzelfde te bereiken. In essentie betekend dit dat de gebruiker altijd bevestigd dat het document gesloten mag worden.

Je kunt en zou moeten om dit event te handelen met window.addEventListener() en het beforeunload event. Meer informatie is daar te vinden.

Specificaties

Het event was van origine geintroduceerd door Microsoft in Internet Explorer 4 en gestandariseerd in de HTML5 specificatie.

Browser compatibiliteit

Zie ook

• MSDN: onbeforeunload event