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

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

Източници