BeforeUnloadEvent: returnValue-Eigenschaft
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
Die returnValue-Eigenschaft des
BeforeUnloadEvent-Interfaces löst, wenn sie auf einen wahrhaftigen Wert gesetzt wird, einen vom Browser erzeugten Bestätigungsdialog aus, der Benutzer fragt, ob sie die Seite wirklich verlassen möchten, wenn sie versuchen, diese zu schließen oder neu zu laden oder zu einer anderen Seite zu navigieren. Dies soll helfen, den Verlust ungespeicherter Daten zu verhindern.
Hinweis:>returnValue ist ein veraltetes Feature. Es ist Best Practice, den Dialog auszulösen, indem Event.preventDefault() bei dem BeforeUnloadEvent-Objekt aufgerufen wird, während returnValue gesetzt wird, um veraltete Fälle zu unterstützen. Siehe die beforeunload-Ereignisreferenz für detaillierte aktuelle Anleitungen.
Wert
returnValue wird mit einem leeren String ("") initialisiert.
Das Setzen auf einen beliebigen wahrhaften Wert führt dazu, dass der Dialog beim Schließen/Neuladen der Seite ausgelöst wird. Beachten Sie jedoch, dass dies auch eine sticky activation erfordert. In anderen Worten: Der Browser zeigt den Dialog nur an, wenn das Frame oder ein eingebettetes Frame eine Benutzeraktion oder Benutzerinteraktion erhält. Wenn der Benutzer nie mit der Seite interagiert hat, gibt es keine Benutzerdaten zu speichern und daher keinen legitimen Anwendungsfall für den Dialog.
Hinweis: Es wird ein generischer, vom Browser vorgegebener String im Dialog angezeigt. Dieser kann nicht durch Code der Webseite gesteuert werden.
Beispiele
Siehe die beforeunload-Ereignisreferenzseite für ein Best-Practice-Beispiel.
Spezifikationen
| Specification |
|---|
| HTML # dom-beforeunloadevent-returnvalue |