Window: beforeunload event
Событие beforeunload запускается, когда окно, документ и его ресурсы вот-вот будут выгружены. Документ все ещё виден, и событие в этот момент может быть отменено.
| Всплываемость | Нет |
|---|---|
| Отменяемость | Да |
| Интерфейс | Event |
| Свойство обработчика событий | onbeforeunload |
Это событие позволяет веб-странице вызвать диалоговое окно подтверждения, спрашивающее пользователя, действительно ли он хочет покинуть страницу. Если пользователь подтверждает, браузер переходит на новую страницу, в противном случае он отменяет навигацию.
В соответствии со спецификацией, для отображения диалогового окна подтверждения обработчик события должен вызватьpreventDefault() по событию.
Однако обратите внимание, что не все браузеры поддерживают этот метод, а некоторые требуют от обработчика событий реализации одного из двух старых методов:
- назначение строки свойству returnValue события
- возвращающий строку из обработчика событий.
Некоторые браузеры используют для отображения возвращаемой строки в диалоге подтверждения, позволяя обработчику события отображать пользователю пользовательское сообщение. Однако это устарело и больше не поддерживается в большинстве браузеров.
Для борьбы с нежелательными всплывающими окнами браузеры могут не отображать подсказки, созданные в обработчиках событий beforeunload, за исключением случаев, когда страница была обработана или даже не отображается вообще.
Прикрепление обработчика событий к window или document beforeunload событие не позволяет браузерам использовать кеш навигации по страницам в памяти, наподобие Firefox's Back-Forward cache or WebKit's Page Cache.
В спецификации HTML указано, что вызовы window.alert(), window.confirm(), и window.prompt() методы могут быть проигнорированы во время этого события. Посмотреть HTML specification для более подробной информации.
Примеры
В HTML-спецификации указано, что авторы должны использовать метод Event.preventDefault(), а не Event.returnValue. Однако, это поддерживается не всеми браузерами.
window.addEventListener("beforeunload", (event) => {
// Отмените событие, как указано в стандарте.
event.preventDefault();
// Chrome требует установки возвратного значения.
event.returnValue = "";
});
Спецификации
| Specification |
|---|
| HTML Standard # event-beforeunload |
| HTML Standard # handler-window-onbeforeunload |
Совместимость с браузерами
BCD tables only load in the browser
Смотрите WindowEventHandlers/onbeforeunload для получения более подробной информации о том, как различные браузеры обрабатывают это событие.