Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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 dieKompatibilitä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.
DieMutationEvent-Schnittstelle bietet Ereigniseigenschaften, die spezifisch für Änderungen an der Document Object Model (DOM)-Hierarchie und -Knoten sind.
Hinweis:Die Verwendung vonMutationsevents ist problematisch:
- Ihr Design istfehlerhaft.
- Das Hinzufügen von DOM-Mutations-Listenern zu einem Dokumentverschlechtert 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
DOMAttrModifiednicht (sieheWebKit-Fehler 8191) und Firefox unterstützt keineMutationsnamen-Ereignisse (wieDOMElementNameChangedundDOMAttributeNameChanged).
Sie wurden zugunsten vonMutation Observers veraltet.Überlegen Sie, stattdessen diese zu verwenden.
Instanzen-Eigenschaften
Diese Schnittstelle erbt auch Eigenschaften von ihrem übergeordnetenUIEvent und indirekt vonEvent.
MutationEvent.attrChangeSchreibgeschütztVeraltetNicht standardisiertGibt 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 auf0gesetzt.MutationEvent.attrNameSchreibgeschütztVeraltetNicht standardisiertGibt 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.newValueSchreibgeschütztVeraltetNicht standardisiertBei
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.prevValueSchreibgeschütztVeraltetNicht standardisiertBei
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 ("").MutationEvent.relatedNodeSchreibgeschütztVeraltetNicht standardisiertGibt 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()VeraltetNicht standardisiertKonstruktor-Methode, die ein neues
MutationEventmit 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)DOMCharacterDataModifiedDOMElementNameChanged(Nicht von Firefox unterstützt)DOMNodeInsertedDOMNodeInsertedIntoDocumentDOMNodeRemovedDOMNodeRemovedFromDocumentDOMSubtreeModified
Beispiele
Sie können einen Listener für Mutationsereignisse registrieren, indem SieEventTarget.addEventListener() wie folgt verwenden:
element.addEventListener("DOMNodeInserted", (event) => { // …});