BeforeUnloadEvent: returnValue property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("HTML DOM")}}
The **returnValue** property of the {{domxref("BeforeUnloadEvent")}} interface, when set to a truthy value, triggers a browser-generated confirmation dialog asking users to confirm if they _really_ want to leave the page when they try to close or reload it, or navigate somewhere else. This is intended to help prevent loss of unsaved data.
توجه: returnValue is a legacy feature, and best practice is to trigger the dialog by invoking {{domxref("Event.preventDefault()")}} on the BeforeUnloadEvent object, while also setting returnValue to support legacy cases. See the {{domxref("Window/beforeunload_event", "beforeunload")}} event reference for detailed up-to-date guidance.
Value
returnValue is initialized to an empty string ("") value.
Setting it to just about any truthy value will cause the dialog to be triggered on page close/reload, however note that it also requires sticky activation. In other words, the browser will only show the dialog if the frame or any embedded frame receives a user gesture or user interaction. If the user has never interacted with the page, then there is no user data to save, so no legitimate use case for the dialog.
توجه: A generic browser-specified string is displayed in the dialog. This cannot be controlled by the webpage code.
Examples
See the {{domxref("Window/beforeunload_event", "beforeunload")}} event reference page for a best practice example.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}