CKTIS / JavaScript
DOMContentLoaded, pagehide и pageshow: готовност на DOM и навигация
Разграничи готовността на DOM, напускането на документ и възстановяването му. Научи какво показват `readyState` и `persisted` и защо не са сигнали за видимост.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);
// onPageHide and onPageShow receive a PageTransitionEvent with a boolean persisted property.DOMContentLoaded е браузърно събитие от тип Event, за което се регистрира слушател на document. То се задейства, след като разборът на HTML приключи и класическите скриптове с defer се изпълнят. Преди да задейства събитието, браузърът започва и оценяването на модулните скриптове без async, добавени от анализатора на HTML. Не изчаква да завършат операциите, изчаквани чрез await на най-горно ниво в тези модули или техните зависимости, така че инициализацията на модулите може още да не е приключила след събитието. Не изчаква изображения, рамки или скриптове с async; таблиците със стилове могат косвено да го забавят, ако блокират отложени скриптове. Това не е събитието load.
Ако кодът може да се изпълни късно и му е нужен само DOM, изграден при разбора на HTML, провери document.readyState. При "loading" добави еднократен слушател за DOMContentLoaded; иначе изпълни инициализацията веднага. "interactive" означава, че разборът е приключил, но не и че DOMContentLoaded вече се е задействало или че другите скриптове са приключили инициализацията си.
На window слушай за pagehide при напускане на документ и за pageshow при зареждането или възстановяването му. И двете събития са от тип PageTransitionEvent с булево свойство persisted. При pagehide стойност true означава, че документът може да се използва повторно, без гаранция; false означава, че няма да се използва повторно. При ново зареждане pageshow следва load със стойност false. При възстановяване от кеша за навигация назад и напред (bfcache) стойността е true: връщат се същият DOM и същото състояние на JavaScript без ново DOMContentLoaded.
Използвай pagehide, за да спреш временно задачите на страницата, а pageshow с persisted === true — за да ги възобновиш или да обновиш остарелите данни. pagehide може да не се задейства, например ако мобилният браузър бъде принудително затворен във фонов режим. Запазвай важните промени веднага; за промени във видимостта използвай visibilitychange и document.visibilityState. Тези събития не сигнализират обикновено превключване между раздели и са част от уеб платформата, а не от ECMAScript.
Примери
(() => {
function installListeners(doc, win) {
const onDomReady = () => console.log("DOM ready");
if (doc.readyState === "loading") {
doc.addEventListener("DOMContentLoaded", onDomReady, { once: true });
} else {
onDomReady();
}
const logTransition = (event) => {
console.log(`${event.type} persisted=${event.persisted}`);
};
win.addEventListener("pagehide", logTransition);
win.addEventListener("pageshow", logTransition);
}
if (typeof document !== "undefined" && typeof window !== "undefined") {
installListeners(document, window);
} else {
// Node.js test: simulate DOM readiness without simulating navigation.
const testDocument = new EventTarget();
const testWindow = new EventTarget();
testDocument.readyState = "loading";
installListeners(testDocument, testWindow);
testDocument.readyState = "interactive";
testDocument.dispatchEvent(new Event("DOMContentLoaded"));
}
})();Резултат
DOM ready
Постави кода веднъж в конзолата на браузъра след пълното зареждане на страницата. Тогава `DOM ready` идва от проверката на `readyState`, а не от повторно събитие. Запази журнала на конзолата, отвори друг документ в същия раздел и се върни назад. Допълнителните редове зависят от навигацията и от това дали браузърът използва bfcache.
Свързани уроци
- JavaScript · Урок 37 · Напреднало · Версия: 4