CKTIS / JavaScript
Gebeurtenissen DOMContentLoaded, pagehide en resize
Kies de passende gebeurtenis: `DOMContentLoaded` als de DOM klaar is, `pagehide` bij het verlaten van een pagina en `resize` als de viewport van grootte verandert.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("resize", onResize);DOMContentLoaded, pagehide en resize horen bij het webplatform, niet bij ECMAScript 2024. Registreer listeners met addEventListener(): de eerste op document en de andere twee op window. De beschikbaarheid hangt af van de uitvoeromgeving; ga er niet van uit dat een worker of Node.js deze browserobjecten als eventdoelen aanbiedt.
DOMContentLoaded is een niet-annuleerbaar Event dat vanaf document omhoog propageert (bubbling). De browser vuurt het af nadat de HTML is geparseerd, klassieke scripts met defer zijn uitgevoerd en de evaluatie is gestart van modulescripts die voor na het parsen zijn ingepland (zonder async). De browser wacht niet tot de asynchrone module-evaluatie is voltooid: een module kan nog gepauzeerd zijn bij een await op het hoogste niveau, of de uitvoering van de modulecode kan nog wachten op een asynchrone afhankelijkheid. Anders dan load wacht het niet rechtstreeks op afbeeldingen, frames of async-scripts. Heb je alleen de geparseerde DOM nodig, registreer dan bij document.readyState === "loading" een listener met { once: true }; initialiseer anders meteen. "interactive" bewijst niet dat het event al is afgevuurd of dat uitgestelde scripts de toestand hebben klaargezet waarvan je code afhankelijk is.
pagehide is een PageTransitionEvent waarop je luistert via window bij het verlaten van een pagina, niet bij alleen het wisselen van tabblad. event.persisted === true betekent dat de pagina in de terug-/vooruitcache (bfcache) kan worden bewaard; false betekent dat dit document niet op die manier terugkomt. true garandeert geen terugkeer: werkelijk herstel herken je aan pageshow met persisted === true, zonder nieuwe DOMContentLoaded. preventDefault() blokkeert de navigatie niet. pagehide kan uitblijven, vooral op mobiele apparaten. Sla belangrijke gegevens daarom eerder op; gebruik voor de overgang naar de achtergrond visibilitychange en controleer document.visibilityState === "hidden".
Het resize-event op window is een niet-annuleerbaar Event dat niet omhoog propageert. Het meldt wijzigingen in de grootte van de viewport, niet van willekeurige elementen. Lees de huidige afmetingen uit window.innerWidth en window.innerHeight; gebruik ResizeObserver om de grootte van een element te volgen. Wijzigingen kunnen snel op elkaar volgen, dus beperk de frequentie van kostbaar lay-outwerk.
Voorbeelden
(() => {
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();
}
})();Resultaat
DOMContentLoaded pagehide: persisted=true resize
Voer de code uit in de browserconsole van een nieuw tabblad met `about:blank`, of sla de code op als `main.js` en voer `node main.js` uit met Node.js 24. In Node.js gebruikt het voorbeeld zelfstandige `EventTarget`-instanties in plaats van `document` en `window`. Synthetische gebeurtenissen controleren de koppeling van de listeners; ze wijzigen de gereedheidsstatus van het document of de viewportgrootte niet, navigeren niet en testen de bfcache niet. `abort()` verwijdert alle drie de listeners.
Gerelateerde lessen
- JavaScript · Les 34 · Gevorderd · Versie: 4