From 4163263b011d42c840e5a3c7deee317bdae6e2cd Mon Sep 17 00:00:00 2001
From: Domenic Denicola
The prompt shown by the user agent may include the string of the returnValue
attribute, optionally truncated.
The message shown to the user is not customizable, but instead determined by
+ the user agent. In particular, the actual value of the returnValue
attribute is ignored.
The user agent must pause while waiting for the user's response.
@@ -82377,13 +82377,14 @@ dictionary PageTransitionEventInit : EventInit {returnValue
[ = value ]returnValue
[ = " " ]Returns the current return value of the event (the message to show the user).
-Can be set, to update the message.
+Can be set, to request that the user agent to confirm with the user their intention to + unload the document. Any value besides the empty string will suffice for this purpose.
The returnValue
attribute
- represents the message to show the user. When the event is created, the attribute must be set to
+ controls the process of prompting to unload the
+ document. When the event is created, the attribute must be set to
the empty string. On getting, it must return the last value it was set to. On setting, the
attribute must be set to the new value.
This attribute is a DOMString
only for historical reasons.
+ Any value besides the empty string will be treated as a request to ask the user for
+ confirmation.
mouseover
events, where the return value has to
be true to cancel the event). With beforeunload
events,
- the value is instead used to determine the message to show the user.
+ the value is instead used to determine whether or not to prompt about unloading the document.
For historical reasons, the onerror
handler has different
arguments: