MutationEvent

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Die MutationEvent-Schnittstelle stellt Ereigniseigenschaften bereit, die spezifisch für Änderungen an der Document Object Model (DOM)-Hierarchie und den Knoten sind.

Hinweis: Die Verwendung von Mutation Events ist problematisch:

Ihr Design ist fehlerhaft.
Das Hinzufügen von DOM-Mutations-Listenern zu einem Dokument verschlechtert die Leistung weiterer DOM-Änderungen in diesem Dokument erheblich (sie werden 1,5- bis 7-mal langsamer!). Darüber hinaus wird der Schaden durch das Entfernen der Listener nicht rückgängig gemacht.
Sie haben schlechte plattformübergreifende Browser-Kompatibilität: Safari unterstützt DOMAttrModified nicht (siehe WebKit Bug 8191) und Firefox unterstützt keine Mutation Name Events (wie DOMElementNameChanged und DOMAttributeNameChanged).

Sie wurden zugunsten von Mutation Observers als veraltet markiert. Bitte verwenden Sie stattdessen diese.

Instanz-Eigenschaften

Diese Schnittstelle erbt auch Eigenschaften von ihrem übergeordneten UIEvent und indirekt von Event.

MutationEvent.attrChange Schreibgeschützt Veraltet: Gibt an, welche Art von Änderung das DOMAttrModified-Ereignis ausgelöst hat. Es kann MODIFICATION (1), ADDITION (2) oder REMOVAL (3) sein. Es hat für andere Ereignisse keine Bedeutung und wird dann auf 0 gesetzt.
MutationEvent.attrName Schreibgeschützt Veraltet: Gibt den Namen des Knotens an, der durch das DOMAttrModified-Ereignis betroffen ist. Für andere Ereignisse hat es keine Bedeutung und wird dann auf den leeren String ("") gesetzt.
MutationEvent.newValue Schreibgeschützt Veraltet: Enthält bei DOMAttrModified-Ereignissen den neuen Wert des modifizierten Attr-Knotens. Bei DOMCharacterDataModified-Ereignissen enthält es den neuen Wert des modifizierten CharacterData-Knotens. In allen anderen Fällen wird der leere String ("") zurückgegeben.
MutationEvent.prevValue Schreibgeschützt Veraltet: Enthält bei DOMAttrModified-Ereignissen den vorherigen Wert des modifizierten Attr-Knotens. Bei DOMCharacterDataModified-Ereignissen enthält es den vorherigen neuen Wert des modifizierten CharacterData-Knotens. In allen anderen Fällen wird der leere String ("") zurückgegeben.
MutationEvent.relatedNode Schreibgeschützt Veraltet: Gibt den mit dem Ereignis verbundenen Knoten an, wie den geänderten Knoten innerhalb der Unterstruktur für DOMSubtreeModified.

Instanz-Methoden

MutationEvent.initMutationEvent() Veraltet: Konstruktormethode, die ein neues MutationEvent mit den gegebenen Parametern konfiguriert zurückgibt.

Liste der Mutation Events

Die folgende Liste enthält alle Mutation Events:

DOMAttrModified (Nicht unterstützt von Safari)
DOMAttributeNameChanged (Nicht unterstützt von Firefox)
DOMCharacterDataModified
DOMElementNameChanged (Nicht unterstützt von Firefox)
DOMNodeInserted
DOMNodeInsertedIntoDocument
DOMNodeRemoved
DOMNodeRemovedFromDocument
DOMSubtreeModified

Beispiele

Sie können einen Listener für Mutation Events registrieren, indem Sie EventTarget.addEventListener() wie folgt verwenden:

element.addEventListener(
  "DOMNodeInserted",
  (event) => {
    // …
  },
  false,
);

Spezifikationen

Specification
UI Events # interface-mutationevent

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

MutationObserver