MutationObserver: disconnect() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die MutationObserver Methode
disconnect() weist den Beobachter an, das Überwachen von
Mutationen zu stoppen.
Der Beobachter kann wiederverwendet werden, indem seine
observe() Methode erneut aufgerufen wird.
Syntax
disconnect()
Parameter
Keine.
Rückgabewert
undefined.
Hinweis:
Alle Benachrichtigungen über bereits erfasste, aber noch nicht gemeldete
Mutationen werden verworfen.
Um die erfassten, aber nicht gemeldeten Mutationen zu behalten und zu verarbeiten, verwenden Sie
die takeRecords() Methode.
Anwendungsnotizen
Wenn das beobachtete Element aus dem DOM entfernt und dann anschließend vom
Garbage-Collection-Mechanismus des Browsers freigegeben wird, wird der MutationObserver aufhören,
das entfernte Element zu beobachten. Der MutationObserver selbst kann jedoch weiterhin existieren,
um andere vorhandene Elemente zu beobachten.
Beispiele
Dieses Beispiel erstellt einen Beobachter und trennt dann die Verbindung von ihm, wodurch er für eine mögliche Wiederverwendung verfügbar bleibt.
const targetNode = document.querySelector("#someElement");
const observerOptions = {
childList: true,
attributes: true,
};
const observer = new MutationObserver(callback);
observer.observe(targetNode, observerOptions);
/* some time later… */
observer.disconnect();
Spezifikationen
| Spezifikation |
|---|
| DOM # ref-for-dom-mutationobserver-disconnect① |