База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Събитията DOMContentLoaded и pagehide

Използвай `DOMContentLoaded` за инициализация след изграждането на DOM, а `pagehide` — за временно спиране на работата при напускане на документа. Възстановяването от bfcache не е ново зареждане.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);

DOMContentLoaded е събитие от тип Event, което се задейства върху document, след като браузърът приключи анализа на HTML, изпълни класическите скриптове с defer и започне оценяването на модулните скриптове без async, предвидени за края на анализа. Събитието не изчаква края на оценяването на модулите: ако изпълнението на зависимост се спре временно при await на най-горно ниво, събитието може да настъпи още преди да започне изпълнението на тялото на модула, който я импортира. То не изчаква изображения, рамки или приключването на скриптове с async. Стиловите таблици могат косвено да го забавят, ако блокират изпълнението на скриптове. Използвай load върху window, ако трябва да изчакаш ресурсите, които забавят зареждането на страницата.

Ако кодът за инициализация може да стартира късно, провери document.readyState: при "loading" регистрирай еднократен слушател за DOMContentLoaded, а иначе използвай вече наличния DOM. "interactive" означава, че анализът е приключил, но не и че събитието непременно е настъпило или че другите скриптове са завършили инициализацията си. Ако зависиш от тях, задай изрично реда на инициализация.

Слушай за pagehide върху window при напускане на документа, например при връщане назад. Това събитие от тип PageTransitionEvent не означава обикновена смяна на раздел и не може да отмени навигацията. event.persisted === true означава, че документът може да се запази в кеша за навигация назад и напред (bfcache), а не че възстановяването е гарантирано. false означава, че документът не се запазва при тази навигация. Спри временно работата при pagehide и я възобнови при pageshow с persisted === true: възстановеният документ запазва своя DOM и не задейства отново DOMContentLoaded.

Записвай важните данни своевременно. pagehide може да не настъпи, особено при принудително затваряне на мобилен браузър, а започнатите тогава асинхронни операции може да не завършат. За да реагираш при скриване на страницата, слушай за visibilitychange върху document и проверявай за състояние "hidden". Това са API на уеб платформата, а не нововъведения в ECMAScript 2024.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DOMContentLoaded and pagehide</title>
  <script>
    (() => {
      const init = () => console.log("DOM ready");

      if (document.readyState === "loading") {
        document.addEventListener("DOMContentLoaded", init, { once: true });
      } else {
        init();
      }

      window.addEventListener("pagehide", (event) => {
        console.log(`pagehide persisted=${event.persisted}`);
      });

      window.addEventListener("pageshow", (event) => {
        if (event.persisted) console.log("pageshow restored");
      });
    })();
  </script>
</head>
<body>
  <p>Open the browser console to see the event log.</p>
</body>
</html>

Резултат

DOM ready

Запази примера като HTML файл и го отвори в браузър. Включи запазването на журнала в конзолата и презареди страницата. `DOM ready` се появява при задействане на `DOMContentLoaded`. Следващите съобщения зависят от навигацията и от това дали браузърът ще запази документа.

Свързани уроци

  • JavaScript · Урок 40 · Напреднало · Версия: 4
  • JavaScript · Урок 41 · Напреднало · Версия: 4

Източници