How can I override the OnBeforeUnload dialog and replace it with my own?

Question

I need to warn users about unsaved changes before they leave a page (a pretty common problem).

window.onbeforeunload=handler

This works but it raises a default dialog with an irritating standard message that wraps my own text. I need to either completely replace the standard message, so my text is clear, or (even better) replace the entire dialog with a modal dialog using jQuery.

So far I have failed and I haven't found anyone else who seems to have an answer. Is it even possible?

Javascript in my page:

<script type="text/javascript">

   window.onbeforeunload=closeIt;

</script>

The closeIt() function:

function closeIt()
{
  if (changes == "true" || files == "true")
  {
      return "Here you can append a custom message to the default dialog.";
  }
}

Using jQuery and jqModal I have tried this kind of thing (using a custom confirm dialog):

$(window).beforeunload(function() {
        confirm('new message: ' + this.href + ' !', this.href);
        return false;
    });

which also doesn't work - I cannot seem to bind to the beforeunload event.

Answer 1

well it looks like you can't modify the default dialogue for onbeforeunload, so your best bet may be to work with it...

window.onbeforeunload = function() {
    return 'You have unsaved changes!';
}

here's a reference to this from microsoft:

When a string is assigned to the returnValue property of window.event, a dialog box appears that gives users the option to stay on the current page and retain the string that was assigned to it. The default statement that appears in the dialog box, "Are you sure you want to navigate away from this page? ... Press OK to continue, or Cancel to stay on the current page.", cannot be removed or altered.

the problem seems to be:

1. when onbeforeunload is called, it will take the return value of the handler as window.event.returnValue.
2. it will then parse the return value as a string (unless it is null)
3. since false is parsed as a string, the dialogue box will fire, which will then pass an appropriate true/false

the result is, there doesn't seem to be a way of assigning false to onbeforeunload, to prevent it from the default dialogue.

additional notes on jQuery:

• setting the event in jQuery may be problematic, as that allows other onbeforeunload events to occur as well. if you wish only for your unload event to occur i'd stick to plain ol javascript for it.

• jQuery doesn't have a short cut for onbeforeunload so you'd have to use the generic bind syntax.

  $(window).bind('beforeunload', function() {} );
  

Answer 2

Owen is correct. And, the reason behind this is security. Preventing a page from unloading is useful in web forms and such, but it can easily be exploited by a malicious site to fool the user into staying on a page. That's why web browsers implement the standard message and have this mechanism for inserting custom text.

Answer 3

Try this:

$(window).unload(function()
{
    alert('blubb'):
});

It works - no problems with jQuery.

Answer 4

see here for more info: http://stackoverflow.com/questions/140460

Answer 5

Why not tie the functionality to zone security. That way, for trusted zones, developers of web apps can create robust functionality like what is being described here.

Answer 6

What about to use the specialized version of the "bind" command "one". Once the event handler executes the first time, it’s automatically removed as an event handler.

$(window).one("beforeunload", BeforeUnload);