KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

IntersectionObserver.unobserve — stoppen met het observeren van één element

De methode unobserve(target) laat een bepaalde IntersectionObserver stoppen met het observeren van het opgegeven element, zonder de andere elementen te veranderen. Reeds in de wachtrij geplaatste meldingen worden niet verwijderd.

Versie: 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.unobserve(target)

IntersectionObserver.unobserve is een instantiemethode die je aanroept als observer.unobserve(target). Het argument target moet een Element zijn, geen selector. De methode retourneert undefined; opnieuw aanroepen voor een element dat niet wordt geobserveerd verandert niets.

unobserve(target) koppelt alleen het opgegeven element los van deze observer. disconnect() koppelt alle elementen los. Een latere aanroep van observe(target) kan de observatie opnieuw starten. Een gebruikelijke toepassing is het volgen te stoppen nadat inhoud één keer is geladen.

Meldingen zijn asynchroon: unobserve(target) verwijdert geen items die al in de wachtrij staan of items die aan een callback zijn doorgegeven die op dat moment wordt uitgevoerd. takeRecords() haalt de volledige wachtrij van de observer op en leegt die; niet alleen de items voor dat element.

Dit is een browser-Web-API, geen functie van een bepaalde ECMAScript-editie. Controleer de beschikbaarheid in de doelbrowser; Node 24 in de repository toont niet aan dat de API wordt ondersteund. Het voorbeeld start en stopt synchroon de observatie van een losgekoppeld element, zonder afhankelijk te zijn van scrollen.

Voorbeelden

(() => {
  const target = document.createElement('div');
  const observer = new IntersectionObserver(() => {
    console.log('unexpected callback');
  });

  observer.observe(target);
  console.log(observer.unobserve(target) === undefined);
  console.log(observer.unobserve(target) === undefined);
  console.log(observer.takeRecords().length);
  observer.disconnect();
})();

Resultaat

true
true
0

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen