BeforeUnloadEvent: returnValue-Eigenschaft
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
Die returnValue-Eigenschaft des
BeforeUnloadEvent-Interfaces, wenn auf einen gültigen (truthy) Wert gesetzt, löst einen browsergenerierten Bestätigungsdialog aus, der Benutzer fragt, ob sie wirklich die Seite verlassen wollen, wenn sie versuchen, diese zu schließen oder neu zu laden oder woanders hin zu navigieren. Dies soll helfen, den Verlust ungespeicherter Daten zu verhindern.
Hinweis:
returnValue ist ein veraltetes Feature, und die beste Praxis ist, den Dialog auszulösen, indem Event.preventDefault() auf dem BeforeUnloadEvent-Objekt aufgerufen wird, während returnValue gesetzt wird, um ältere Fälle zu unterstützen. Siehe die beforeunload-Ereignisreferenz für detaillierte, aktuelle Anleitungen.
Wert
returnValue ist initial auf einen leeren String ("") gesetzt.
Das Setzen auf jeden truthy Wert wird dazu führen, dass der Dialog beim Schließen/Neuladen der Seite ausgelöst wird. Beachten Sie jedoch, dass dies auch eine sticky activation erfordert. Mit anderen Worten, der Browser zeigt den Dialog nur an, wenn der Frame oder ein eingebetteter Frame eine Benutzerinteraktion erhält. Wenn der Benutzer nie mit der Seite interagiert hat, gibt es keine Benutzerdaten zu speichern und somit keinen legitimen Anwendungsfall für den Dialog.
Hinweis: Im Dialog wird eine generische, vom Browser festgelegte Zeichenkette angezeigt. Diese kann nicht durch den Webseiten-Code gesteuert werden.
Beispiele
Siehe die beforeunload-Ereignisreferenzseite für ein Beispiel zur besten Praxis.
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-beforeunloadevent-returnvalue |