before-unload v2.0.0

before-unload

A generic onbeforeunload handler. Will check a condition, or a list of supplied conditions, to determine if it is safe to unload.

The examples are available on the github project page.

Browser support

It supports newer ES5 compatible browsers. And it should be able to support most elderly browsers if you provide them with an ES5 shim.

Installation

Install it from npm:

$ npm install before-unload

Usage

Simple condition

In the following example, the user will be prompted on the beforeunload event, if the ViewModel.hasChanges method returns a truthy value.

new BeforeUnload('Are you sure you want to leave?', function () {
    return ViewModel.hasChanges();
});

Multiple conditions

In the following example, the user will be prompted on the beforeunload event, if the ViewModel.hasChanges method or the Storage.unsavedChanges method returns a truthy value.

new BeforeUnload('Are you sure you want to leave?', [
    function () {
        return ViewModel.hasChanges();
    },
    function () {
        return Storage.unsavedChanges();
    }
]);

Conditions with custom messages

In the following example, a different warning is shown for one of the conditions.

new BeforeUnload('Are you sure you want to leave?', [
    function () {
        return ViewModel.hasChanges();
    },
    function () {
        return Storage.unsavedChanges();
    },
    function () {
    	return SomeObject.isItOkayToLeave() ? false : 'A custom error message';
	}
]);

• If a false is returned from a condition, no warning is shown.
• If a boolean true value is returned, the default message set in the constructor is shown.
• If a string value is returned, that is displayed.

Unregistering the beforeunload event listener.

If you store a reference to the BeforeUnload object, you can unregister the event listener.

If a user attempts to leave the page after the unregister call, she will not be prompted.

var beforeUnload = new BeforeUnload(
    'Are you sure you want to leave?',
    function () {}
);

beforeUnload.unregister();