WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Browserereignisse und Ereignisausbreitung

Mit Ereignissen reagiert Code auf Nutzeraktionen und Änderungen des Seitenzustands. Lerne Erfassungsphase, Zielphase und Bubbling kennen, unterscheide das Verhindern der Standardaktion vom Stoppen der Ausbreitung und entdecke Ereignisse für Lebenszyklus, Sichtbarkeit, Scrollen, Größenänderung und Eingabe.

Version: Web APIs defined by web standards, not ECMAScript editions. Check support in target browsers; Node 24 in the repository does not establish browser API support.

Syntax

target.addEventListener(type, handler, options);
target.removeEventListener(type, handler, options);
target.dispatchEvent(event);

Modell und Geltungsbereich

Browserereignisse gehören zu den APIs der Laufzeitumgebung, nicht zur ECMAScript-Syntax. Der DOM-Standard definiert das Ereignismodell, die Auslösung und Ausbreitung von Ereignissen sowie die Listener-Optionen. Der HTML-Standard legt unter anderem fest, wann DOMContentLoaded und load sowie input und change bei Formularsteuerelementen ausgelöst werden. Ordne diese APIs keiner ECMAScript-Ausgabe zu. Node 24 belegt keine Unterstützung von Browser-APIs. Prüfe die Kompatibilität in den Zielbrowsern.

Ausbreitung und Abbruch

addEventListener(type, handler, options) registriert einen Handler. Auf die Erfassung bei Vorfahren folgt das Ziel und bei bubbles auch Bubbling bei Vorfahren. target ist das Ziel, currentTarget das Objekt des laufenden Listeners. stopPropagation() stoppt die weitere Ausbreitung, ohne die übrigen Listener im laufenden Durchlauf zu überspringen. Ruft jedoch ein Capture-Listener am Ziel stopPropagation() auf, entfällt der separate Durchlauf für die Listener ohne Capture an demselben Ziel. stopImmediatePropagation() überspringt auch die übrigen Listener im laufenden Durchlauf. preventDefault() verhindert die Standardaktion nur bei abbrechbaren Ereignissen außerhalb passiver Listener, nicht die Ausbreitung.

Lebenszyklus und Sichtbarkeit

DOMContentLoaded auf document: Parsing und Skripte, die das Ereignis verzögern, sind fertig, nicht alle Ressourcen. load auf window wartet auch auf Ressourcen, die es verzögern. Bei pageshow und pagehide geht es auch um den Vor-/Zurück-Cache: Prüfe persisted. Lies bei visibilitychange auf document den Wert document.visibilityState. Unsichtbar heißt nicht geschlossen; unload garantiert kein abschließendes Speichern.

Scrollen, Größe und Eingabe

scroll betrifft das Scrollziel, resize auf window die Viewportgröße. Nicht alles bubbelt. Halte häufige Handler schlank. input meldet Nutzereingaben, change deren Übernahme je nach Steuerelement; .value zu setzen löst keines aus. Unterscheide keydown, Pointer-Ereignisse und semantisches click; biete mehr als Mausbedienung.

Listener verwalten

once entfernt den Listener, bevor seine Callback-Funktion zum ersten Mal aufgerufen wird. Löst diese Funktion synchron ein weiteres Ereignis desselben Typs aus, verarbeitet der entfernte Listener dieses Ereignis nicht. passive macht preventDefault() unwirksam, signal erlaubt Entfernen per Abbruch. Für removeEventListener Typ, Funktionsreferenz und capture-Wert behalten. dispatchEvent() läuft im Beispiel synchron: false bedeutet Abbruch, nicht Ausbreitungsstopp.

In diesem Eintrag behandelte Referenzbezeichner: Page lifecycle, visibility, scroll/resize and input events.

Beispiele

(() => {
  const parent = document.createElement('div');
  const child = document.createElement('button');
  parent.append(child);
  const log = [];

  parent.addEventListener('demo', () => log.push('capture'), { capture: true });
  child.addEventListener('demo', event => {
    log.push('target');
    event.preventDefault();
  });
  parent.addEventListener('demo', () => log.push('bubble'));

  const accepted = child.dispatchEvent(new Event('demo', {
    bubbles: true,
    cancelable: true
  }));
  console.log(log.join(' > '));
  console.log(accepted);
})();

Ergebnis

capture > target > bubble
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen