Fenster: Load-Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Das load-Ereignis wird ausgelöst, wenn die gesamte Seite geladen ist, einschließlich aller abhängigen Ressourcen wie Stylesheets, Skripte, iframes und Bilder, mit Ausnahme der Ressourcen, die lazy geladen werden. Dies steht im Gegensatz zu DOMContentLoaded, das ausgelöst wird, sobald das DOM der Seite geladen ist, ohne auf das Laden von Ressourcen zu warten.

Dieses Ereignis kann nicht abgebrochen werden und breitet sich nicht aus.

Hinweis: Alle Ereignisse, die load genannt werden, werden nicht an Window weitergeleitet, selbst wenn bubbles auf true gesetzt ist. Um load-Ereignisse auf dem window zu erfassen, muss dieses load-Ereignis direkt auf das window ausgelöst werden.

Hinweis: Das load-Ereignis, das ausgelöst wird, wenn das Hauptdokument geladen ist, wird auf dem window ausgelöst, jedoch mit zwei veränderten Eigenschaften: target ist document, und path ist undefined. Diese beiden Eigenschaften sind aufgrund der Konformität mit älteren Standarden verändert.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("load", (event) => {});

onload = (event) => {};

Ereignistyp

Ein generisches Event.

Beispiele

Protokollieren Sie eine Nachricht, wenn die Seite vollständig geladen ist:

js
window.addEventListener("load", (event) => {
  console.log("page is fully loaded");
});

Dasselbe, aber mit der onload-Ereignishandler-Eigenschaft:

js
window.onload = (event) => {
  console.log("page is fully loaded");
};

Live-Beispiel

HTML

html
<div class="controls">
  <button id="reload" type="button">Reload</button>
</div>

<div class="event-log">
  <label for="eventLog">Event log:</label>
  <textarea
    readonly
    class="event-log-contents"
    rows="8"
    cols="30"
    id="eventLog"></textarea>
</div>

JavaScript

js
const log = document.querySelector(".event-log-contents");
const reload = document.querySelector("#reload");

reload.addEventListener("click", () => {
  log.textContent = "";
  setTimeout(() => {
    window.location.reload(true);
  }, 200);
});

window.addEventListener("load", (event) => {
  log.textContent += "load\n";
});

document.addEventListener("readystatechange", (event) => {
  log.textContent += `readystate: ${document.readyState}\n`;
});

document.addEventListener("DOMContentLoaded", (event) => {
  log.textContent += `DOMContentLoaded\n`;
});

Ergebnis

Spezifikationen

Specification
UI Events
# event-type-load
HTML
# delay-the-load-event

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch