BeforeUnloadEvent: свойство returnValue

Устаревшее: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её поддерживать, она может быть удалена из соответствующих веб-стандартов, может быть в процессе удаления или может оставаться только для совместимости. Избегайте её использования и, если возможно, обновите существующий код; обратитесь к таблице совместимости в конце этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любой момент.

Свойство returnValue интерфейса BeforeUnloadEvent, когда установлено в истинное значение, запускает диалоговое окно подтверждения, генерируемое браузером, которое спрашивает пользователя, действительно ли он хочет покинуть страницу при попытке её закрытия или перезагрузки, или перехода на другую страницу. Это призвано предотвратить потерю несохранённых данных.

Примечание: returnValue — это устаревшая функция, и лучший способ запустить диалог — вызвать Event.preventDefault() для объекта BeforeUnloadEvent, одновременно установив returnValue, чтобы поддержать устаревшие случаи. Обратитесь к ссылке на событие beforeunload для подробных обновлённых рекомендаций.

Значение

returnValue инициализируется пустой строкой ("") значением.

Установка любого истинного значения вызовет запуск диалогового окна при закрытии/перезагрузке страницы, однако имейте в виду, что это также требует привязку активации. Другими словами, браузер покажет диалоговое окно только если кадр или любой вложенный кадр получат пользовательский жест или взаимодействие. Если пользователь никогда не взаимодействовал с страницей, то нет данных пользователя для сохранения, поэтому нет обоснованного использования диалогового окна.

Примечание: В диалоговом окне отображается строка, заданная браузером. Код веб-страницы не может её контролировать.

Примеры

См. страницу справки по событию beforeunload для примера наилучшей практики.

Спецификации

Спецификация
HTML # dom-beforeunloadevent-returnvalue

Совместимость с браузерами

	Рабочий стол					Мобильный
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`returnValue`	119 30–119 До Chrome 119 пустая строка неправильно активировала диалоговое окно подтверждения.	12	1.5	105 17–105 До Opera 105 пустая строка неправильно активировала диалоговое окно подтверждения.	7	119 30–119 До Chrome Android 119 пустая строка неправильно активировала диалоговое окно подтверждения.	4	79 18–79 До Opera Android 79 пустая строка неправильно активировала диалоговое окно подтверждения.	7	3.0	≤37

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BeforeUnloadEvent/returnValue