Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Zdarzenia DOMContentLoaded, pagehide i resize

Dobierz zdarzenie do zadania: `DOMContentLoaded` sygnalizuje gotowość DOM-u, `pagehide` — opuszczanie strony, a `resize` — zmianę rozmiaru obszaru widoku.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("resize", onResize);

DOMContentLoaded, pagehide i resize to zdarzenia platformy webowej, a nie część ECMAScript 2024. Rejestruj je przez addEventListener(): pierwsze na document, pozostałe dwa na window. Dostępność zależy od środowiska; nie zakładaj, że worker lub Node.js udostępnia te przeglądarkowe obiekty docelowe.

DOMContentLoaded to nieanulowalne zdarzenie typu Event, które propaguje się z document w fazie bąbelkowania. Przeglądarka wysyła je po przetworzeniu HTML, wykonaniu klasycznych skryptów z defer i rozpoczęciu ewaluacji skryptów modułowych przewidzianych do uruchomienia po parsowaniu (bez async). Nie czeka na zakończenie asynchronicznej ewaluacji modułów: moduł może nadal być wstrzymany na await najwyższego poziomu albo wykonanie jego kodu może jeszcze czekać na asynchroniczną zależność. W odróżnieniu od load nie czeka bezpośrednio na obrazy, ramki ani skrypty async. Jeśli potrzebujesz tylko gotowego DOM-u, przy document.readyState === "loading" zarejestruj nasłuchiwanie z { once: true }, a w przeciwnym razie wykonaj inicjalizację od razu. Stan "interactive" nie dowodzi, że zdarzenie już wystąpiło ani że skrypty odroczone wykonały inicjalizację, od której zależy Twój kod.

pagehide to PageTransitionEvent obsługiwane na window przy opuszczaniu strony, a nie przy samym przełączeniu karty. event.persisted === true oznacza, że strona może trafić do pamięci nawigacji wstecz/dalej (bfcache); false oznacza, że ten dokument nie zostanie w ten sposób przywrócony. true nie gwarantuje powrotu: faktyczne przywrócenie rozpoznasz po pageshow z persisted === true, bez ponownego DOMContentLoaded. preventDefault() nie zatrzyma nawigacji. pagehide może nie wystąpić, zwłaszcza na urządzeniach mobilnych, więc zapisuj ważne dane wcześniej; do wykrywania przejścia w tło użyj visibilitychange i sprawdź document.visibilityState === "hidden".

resize na window to nieanulowalne zdarzenie typu Event, które nie bąbelkuje. Sygnalizuje zmianę rozmiaru obszaru widoku, nie dowolnego elementu. Odczytaj bieżące wymiary z window.innerWidth i window.innerHeight, a do obserwowania rozmiaru elementu użyj ResizeObserver. Zmiany mogą następować szybko, więc ogranicz częstotliwość kosztownych obliczeń układu.

Przykłady

(() => {
  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();
  }
})();

Wynik

DOMContentLoaded
pagehide: persisted=true
resize

Uruchom w konsoli przeglądarki na świeżo otwartej karcie `about:blank` albo zapisz kod jako `main.js` i uruchom `node main.js` w Node.js 24. W Node.js przykład używa samodzielnych obiektów `EventTarget` zamiast `document` i `window`. Syntetyczne zdarzenia sprawdzają powiązanie funkcji obsługi z obiektami docelowymi; nie zmieniają gotowości dokumentu ani rozmiaru widoku i nie powodują nawigacji ani użycia bfcache. `abort()` usuwa wszystkie trzy funkcje nasłuchujące.

Powiązane lekcje

  • JavaScript · Lekcja 34 · Zaawansowany · Wersja: 4

Źródła