MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

WindowEventHandlers.onbeforeunload

В процессе перевода.

 

Свойство WindowEventHandlers.onbeforeunload сожержит код, который выполняется при отправке события beforeunload. Это событие срабатывает когда окно браузера unload свои ресурсы. При этом документ остаётся видимым и событие все ещё можно отменить.

Примечание: Для борьбы с нежелательными всплывающими окнами, некоторые браузеры не отображают текст передаваемый в beforeunload событии, если они не связаны с самой страницей; некоторые не показывают их вообще. Список конкретных браузеров смотрите в секции: Совместимость_с_браузерами.

Синтаксис

window.onbeforeunload = funcRef
  • funcRef является ссылкой на функцию или выражение функции.
  • Функция должна назначать строковое значение свойству returnValue объекта Event и возвращать ту же строку.

Пример

window.onbeforeunload = function(e) {
  var dialogText = 'Dialog text here';
  e.returnValue = dialogText;
  return dialogText;
};

Примечания

When this event returns (or sets the returnValue property to) a value other than null or undefined, the user is prompted to confirm the page unload. In some browsers, the return value of the event is displayed in this dialog. Starting with Firefox 4, Chrome 51, Opera 38 and Safari 9.1, a generic string not under the control of the webpage will be shown instead of the returned string. For example, Firefox displays the string "This page is asking you to confirm that you want to leave - data you have entered may not be saved." See баг 588292 and Chrome Platform Status.

Since 25 May 2011, the HTML5 specification states that calls to window.alert(), window.confirm(), and window.prompt() methods may be ignored during this event. See the HTML5 specification for more details.

Note also, that various mobile browsers ignore the result of the event (that is, they do not ask the user for confirmation). Firefox has a hidden preference in about:config to do the same. In essence this means the user always confirms that the document may be unloaded.

You can and should handle this event through window.addEventListener() and the beforeunload event. More documentation is available there.

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

Событие было первоначально добавлено Microsoft в Internet Explorer 4 и стандартизовано в HTML5 спецификации.

Specification Status Comment
WHATWG HTML Living Standard
Определение 'GlobalEventHandlers' в этой спецификации.
Живой стандарт  
HTML 5.1
Определение 'GlobalEventHandlers' в этой спецификации.
Рекомендация  
HTML5
Определение 'GlobalEventHandlers' в этой спецификации.
Рекомендация  

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

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 1.0 (Да) 1 4 12 3
Custom text support removed 51.0 Нет 44.0 (44.0)   38 9.1
Feature Android Android Webview Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile Chrome for Android
Basic support ? (Да) (Да) ? ? ? (no) defect (Да)
Custom text support removed ? 51.0 Нет 44.0 (44.0)       51.0

Смотрите также

Метки документа и участники

 Внесли вклад в эту страницу: WispProxy, vitalyzhakov, artemderzkiy, rtf-const
 Обновлялась последний раз: WispProxy,