BeforeUnloadEvent: returnValue-Eigenschaft
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.
Die returnValue-Eigenschaft des BeforeUnloadEvent-Interfaces, löst, wenn auf einen wahrheitsgemäßen Wert gesetzt, einen vom Browser generierten Bestätigungsdialog aus. Dieser fragt die Benutzer, ob sie die Seite wirklich verlassen möchten, wenn sie versuchen, sie zu schließen, neu zu laden oder woanders hin zu navigieren. Dies soll helfen, den Verlust nicht gespeicherter Daten zu verhindern.
Hinweis: returnValue ist ein veraltetes Feature und die beste Praxis ist es, den Dialog durch Aufrufen von Event.preventDefault() auf dem BeforeUnloadEvent-Objekt auszulösen, während returnValue gesetzt bleibt, um ältere Fälle zu unterstützen. Siehe die Referenz zum beforeunload-Ereignis für detaillierte aktuelle Anleitungen.
Wert
returnValue wird auf einen leeren String ("") initialisiert.
Das Setzen auf nahezu jeden wahrheitsgemäßen Wert wird dazu führen, dass der Dialog beim Schließen/Neuladen der Seite ausgelöst wird. Beachten Sie jedoch, dass es auch sticky activation erfordert. Mit anderen Worten: Der Browser zeigt den Dialog nur an, wenn der Frame oder ein eingebetteter Frame eine Benutzeraktion oder Interaktion erhält. Wenn der Benutzer niemals mit der Seite interagiert hat, gibt es keine Benutzerdaten zu speichern und damit keinen legitimen Anwendungsfall für den Dialog.
Hinweis: Im Dialog wird ein vom Browser festgelegter generischer String angezeigt. Dieser kann nicht durch den Webseiten-Code kontrolliert werden.
Beispiele
Siehe die Referenzseite zum beforeunload-Ereignis für ein Best-Practice-Beispiel.
Spezifikationen
| Specification |
|---|
| HTML Standard # dom-beforeunloadevent-returnvalue |
Browser-Kompatibilität
BCD tables only load in the browser