CKTIS / JavaScript
Жизнен цикъл на страницата: видимост, напускане и връщане
Разграничавай скрит раздел, опит за напускане на страницата и възстановяване от кеша за навигация назад и напред, за да записваш състояние, да предупреждаваш или да подновяваш работа навреме.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
document.addEventListener('visibilitychange', onVisibilityChange); // Read document.visibilityState or document.hidden.
window.addEventListener('beforeunload', onBeforeUnload); // Register only while unsaved changes exist.
window.removeEventListener('beforeunload', onBeforeUnload); // Remove the same listener once changes are saved or discarded.
window.addEventListener('pagehide', onPageHide); // Read event.persisted.
window.addEventListener('pageshow', onPageShow); // Read event.persisted.Тези четири събития са част от уеб платформата, а не от ECMAScript 2024. Поддръжката и поведението зависят от браузъра и ситуацията. Не разчитай, че и четирите събития ще настъпят в определен ред.
Слушай за visibilitychange върху document. Това събитие не може да бъде отменено. Прочети document.visibilityState (visible или hidden) или булевата стойност document.hidden. Смяната на раздел може да скрие страницата, без да я напускаш. Записвай състоянието в хода на работата и приемай прехода към hidden като най-подходящ сигнал за последен запис или пауза, а не като доказателство, че сесията е приключила.
beforeunload върху window е отменимо събитие от тип BeforeUnloadEvent, свързано с опит за напускане, презареждане или затваряне на страницата. За да поискаш потвърждение, извикай event.preventDefault() и за съвместимост с по-стари браузъри задай непразен низ на event.returnValue. Връщането на стойност от обработчика действа само чрез onbeforeunload, не чрез addEventListener(). Диалогът изисква предходно подходящо действие от потребителя (sticky activation); браузърът може да не го покаже и определя текста му. Регистрирай обработчика само при незаписани промени и го премахни след записване или отхвърляне на промените: той може да попречи на използването на bfcache, включително във Firefox.
pagehide и pageshow са неотменими събития от тип PageTransitionEvent върху window. При напускане pagehide с event.persisted === true означава, че браузърът възнамерява да запази документа в паметта за навигация назад и напред (bfcache), но не гарантира възстановяването му. false означава, че браузърът не възнамерява да го запази. Използвай pagehide, за да поставиш на пауза работата с ресурси, а не за запис на критични данни: и това събитие, и beforeunload може да не настъпят, например ако мобилната операционна система прекрати браузъра във фонов режим.
При първоначално зареждане pageshow следва load и има persisted === false. Стойност true означава, че същият документ действително е възстановен от bfcache: поднови спряната работа и обнови данните, които може да са остарели. pageshow не означава, че потребителят вижда страницата; може да настъпи и във фонов раздел.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Page lifecycle events</title>
</head>
<body>
<label><input id="dirty" type="checkbox" autocomplete="off"> Simulate unsaved changes</label>
<script>
const dirty = document.getElementById('dirty');
function warn(event) {
console.log('beforeunload');
event.preventDefault();
event.returnValue = 'unsaved'; // Legacy compatibility, not dialog text.
}
dirty.addEventListener('change', () => {
if (dirty.checked) {
window.addEventListener('beforeunload', warn);
} else {
window.removeEventListener('beforeunload', warn);
}
});
document.addEventListener('visibilitychange', () => {
console.log(`visibilitychange: ${document.visibilityState}`);
});
for (const type of ['pagehide', 'pageshow']) {
window.addEventListener(type, (event) => {
console.log(`${type}: persisted=${event.persisted}`);
});
}
console.log('ready');
</script>
</body>
</html>Резултат
ready Then, for example, after switching away from the tab and back: visibilitychange: hidden visibilitychange: visible Other lines (not guaranteed and not in a fixed cross-event order): beforeunload pagehide: persisted=true pageshow: persisted=true A dispatched page transition event can also report persisted=false.
Отвори примера като HTML страница в браузъра и погледни в конзолата. `ready` се появява веднага; следващите съобщения зависят от действията ти и от браузъра. Полето за отметка симулира незаписани промени, но не записва нищо.
Свързани уроци
- JavaScript · Урок 35 · Напреднало · Версия: 4