CKTIS / JavaScript
IntersectionObserver.disconnect(): Beobachtung beenden
disconnect() beendet die Beobachtung aller Ziele durch einen IntersectionObserver, lässt den Observer aber weiterhin wiederverwenden.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
observer.disconnect()observer.disconnect() entfernt alle Ziele aus der Beobachtung durch diesen Observer. Die Methode nimmt keine Argumente entgegen und gibt undefined zurück. Anders als unobserve(target) ist sie nicht auf ein einzelnes Element beschränkt. Wiederholte Aufrufe sind unbedenklich; ein späteres observe(target) startet die Beobachtung erneut.
Die Methode leert keine bereits vorhandenen Einträge in der Warteschlange. Daher kann eine schon eingereihte Benachrichtigung den Callback weiterhin aufrufen. Mit takeRecords() kannst du ausstehende Einträge abrufen und die Warteschlange leeren; verarbeite das Ergebnis oder verwirf es bewusst. Rufe disconnect() beim Aufräumen einer Komponente auf. Dies ist eine Web-API und keine Funktion einer bestimmten ECMAScript-Version; prüfe, ob IntersectionObserver im Zielbrowser verfügbar ist.
Beispiele
(() => {
const targets = [document.createElement('div'), document.createElement('div')];
const observer = new IntersectionObserver(() => {});
targets.forEach(target => observer.observe(target));
console.log(observer.disconnect() === undefined);
observer.disconnect();
console.log(observer.takeRecords().length);
observer.observe(targets[0]);
observer.disconnect();
})();Ergebnis
true 0
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.