BeforeUnloadEvent

The BeforeUnloadEvent interface represents the event object for the beforeunload event, which is fired when the current window, contained document, and associated resources are about to be unloaded.

See the beforeunload event reference for detailed guidance on using this event.

Event BeforeUnloadEvent

Instance properties

Inherits properties from its parent, Event.

returnValue Deprecated

When set to a truthy value, triggers a browser-controlled confirmation dialog asking users to confirm if they want to leave the page when they try to close or reload it. This is a legacy feature, and best practice is to trigger the dialog by invoking event.preventDefault(), while also setting returnValue to support legacy cases.

Instance methods

Inherits methods from its parent, Event.

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android
BeforeUnloadEvent 30 12 1.5 17 7 30 4 18 7 3.0 ≤37
returnValue 119
30–119Before Chrome 119, an empty string incorrectly activated the confirmation dialog.
12 1.5 105
17–105Before Opera 105, an empty string incorrectly activated the confirmation dialog.
7 119
30–119Before Chrome 119, an empty string incorrectly activated the confirmation dialog.
4 79
18–79Before Opera 79, an empty string incorrectly activated the confirmation dialog.
7 3.0 ≤37
user_interaction 60 79 44 47 11 60 44 44 11 8.0 60

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BeforeUnloadEvent