CKTIS / JavaScript
Събитията DOMContentLoaded, pagehide и resize
Избери събитието според задачата: `DOMContentLoaded` за готов DOM, `pagehide` при напускане на страница и `resize` при промяна на размера на областта за визуализация.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("resize", onResize);DOMContentLoaded, pagehide и resize са събития на уеб платформата, а не част от ECMAScript 2024. Регистрирай обработчиците с addEventListener(): първия върху document, а другите два върху window. Наличността зависи от средата за изпълнение; не приемай, че worker или Node.js предоставя тези браузърни обекти като цели на събитията.
DOMContentLoaded е събитие от тип Event, което не може да се отмени и се разпространява нагоре от document. Браузърът го задейства, след като разбере HTML, изпълни класическите скриптове с defer и започне оценяването на модулните скриптове, предвидени за изпълнение след разбора (без async). Той не изчаква асинхронното оценяване на модулите да приключи: модулът може още да е спрял на await на най-горно ниво или изпълнението на тялото му все още да изчаква асинхронна зависимост. За разлика от load, то не чака пряко изображенията, рамките или скриптовете с async. Ако ти трябва само DOM след разбора, при document.readyState === "loading" регистрирай обработчик с { once: true }; в противен случай инициализирай веднага. "interactive" не доказва, че събитието вече е настъпило или че отложените скриптове са подготвили състоянието, от което зависи кодът ти.
pagehide е PageTransitionEvent, което се слуша върху window при напускане на страницата, а не при обикновено превключване на раздел. event.persisted === true означава, че страницата може да бъде запазена в кеша за навигация назад и напред (bfcache); false означава, че документът няма да бъде възстановен по този начин. true не гарантира връщане: разпознай действителното възстановяване по pageshow с persisted === true, без ново DOMContentLoaded. preventDefault() не спира навигацията. pagehide може да не настъпи, особено на мобилни устройства, затова запазвай важните данни по-рано. За преминаване във фонов режим използвай visibilitychange и провери document.visibilityState === "hidden".
resize върху window е събитие от тип Event, което не може да се отмени и не се разпространява нагоре. То съобщава за промяна в размера на областта за визуализация, а не на произволен елемент. Прочети текущите размери от window.innerWidth и window.innerHeight; за наблюдение на размера на елемент използвай ResizeObserver. Промените могат да следват бързо една след друга, затова ограничи честотата на скъпите изчисления на оформлението.
Примери
(() => {
const documentTarget = globalThis.document ?? new EventTarget();
const windowTarget = globalThis.window ?? new EventTarget();
const controller = new AbortController();
const options = { signal: controller.signal };
documentTarget.addEventListener("DOMContentLoaded", (event) => {
console.log(event.type);
}, options);
windowTarget.addEventListener("pagehide", (event) => {
console.log(`${event.type}: persisted=${event.persisted}`);
}, options);
windowTarget.addEventListener("resize", (event) => {
console.log(event.type);
}, options);
try {
documentTarget.dispatchEvent(new Event("DOMContentLoaded", { bubbles: true }));
const pagehide = typeof PageTransitionEvent === "function"
? new PageTransitionEvent("pagehide", { persisted: true })
: Object.assign(new Event("pagehide"), { persisted: true });
windowTarget.dispatchEvent(pagehide);
windowTarget.dispatchEvent(new Event("resize"));
} finally {
controller.abort();
}
})();Резултат
DOMContentLoaded pagehide: persisted=true resize
Изпълни кода в конзолата на браузъра в нов раздел `about:blank` или го запази като `main.js` и изпълни `node main.js` с Node.js 24. В Node.js примерът използва самостоятелни екземпляри на `EventTarget` вместо `document` и `window`. Синтетичните събития проверяват свързването на обработчиците; те не променят готовността на документа или размера на областта за визуализация, не предизвикват навигация и не тестват bfcache. `abort()` премахва и трите обработчика.
Свързани уроци
- JavaScript · Урок 34 · Напреднало · Версия: 4