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.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die MutationEvent
-Schnittstelle bietet Ereigniseigenschaften, die spezifisch für Änderungen an der Document Object Model (DOM)-Hierarchie und -Knoten sind.
Hinweis: Die Verwendung von Mutationsevents ist problematisch:
- Ihr Design ist fehlerhaft.
- Das Hinzufügen von DOM-Mutations-Listenern zu einem Dokument verschlechtert die Leistung erheblich weiterer DOM-Änderungen an diesem Dokument (sie werden 1,5 - 7 Mal langsamer!). Darüber hinaus behebt das Entfernen der Listener den Schaden nicht.
- Sie haben eine schlechte plattformübergreifende Kompatibilität: Safari unterstützt
DOMAttrModified
nicht (siehe WebKit-Fehler 8191) und Firefox unterstützt keine Mutationsnamen-Ereignisse (wieDOMElementNameChanged
undDOMAttributeNameChanged
).
Sie wurden zugunsten von Mutation Observers veraltet. Überlegen Sie, stattdessen diese zu verwenden.
Instanzen-Eigenschaften
Diese Schnittstelle erbt auch Eigenschaften von ihrem übergeordneten UIEvent
und indirekt von Event
.
MutationEvent.attrChange
Schreibgeschützt Veraltet Nicht standardisiert-
Gibt an, welche Art von Änderung das
DOMAttrModified
-Ereignis ausgelöst hat. Es kannMODIFICATION
(1
),ADDITION
(2
) oderREMOVAL
(3
) sein. Für andere Ereignisse hat es keine Bedeutung und ist dann auf0
gesetzt. MutationEvent.attrName
Schreibgeschützt Veraltet Nicht standardisiert-
Gibt den Namen des Knotens an, der vom
DOMAttrModified
-Ereignis betroffen ist. Für andere Ereignisse hat es keine Bedeutung und ist dann auf den leeren String (""
) gesetzt. MutationEvent.newValue
Schreibgeschützt Veraltet Nicht standardisiert-
Bei
DOMAttrModified
-Ereignissen enthält den neuen Wert des modifiziertenAttr
-Knotens. BeiDOMCharacterDataModified
-Ereignissen enthält den neuen Wert des modifiziertenCharacterData
-Knotens. In allen anderen Fällen zurückgegeben als leerer String (""
). MutationEvent.prevValue
Schreibgeschützt Veraltet Nicht standardisiert-
Bei
DOMAttrModified
-Ereignissen enthält den vorherigen Wert des modifiziertenAttr
-Knotens. BeiDOMCharacterDataModified
-Ereignissen enthält den vorherigen Wert des modifiziertenCharacterData
-Knotens. In allen anderen Fällen zurückgegeben als leerer String (""
). -
Gibt den Knoten an, der sich auf das Ereignis bezieht, wie etwa der geänderte Knoten innerhalb des Unterbaums für
DOMSubtreeModified
.
Instanzen-Methoden
MutationEvent.initMutationEvent()
Veraltet Nicht standardisiert-
Konstruktor-Methode, die ein neues
MutationEvent
mit den angegebenen Parametern konfiguriert zurückgibt.
Liste der Mutationsereignisse
Die folgende Liste zeigt alle Mutationsereignisse:
DOMAttrModified
(Nicht von Safari unterstützt)DOMAttributeNameChanged
(Nicht von Firefox unterstützt)DOMCharacterDataModified
DOMElementNameChanged
(Nicht von Firefox unterstützt)DOMNodeInserted
DOMNodeInsertedIntoDocument
DOMNodeRemoved
DOMNodeRemovedFromDocument
DOMSubtreeModified
Beispiele
Sie können einen Listener für Mutationsereignisse registrieren, indem Sie EventTarget.addEventListener()
wie folgt verwenden:
element.addEventListener("DOMNodeInserted", (event) => {
// …
});
Spezifikationen
This feature does not appear to be defined in any specification.>Browser-Kompatibilität
Loading…