CKTIS / JavaScript
IntersectionObserver.unobserve — dejar de observar un elemento
El método unobserve(target) hace que un IntersectionObserver deje de observar el elemento indicado, sin modificar los demás elementos observados. No elimina las notificaciones que ya están en cola.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
observer.unobserve(target)IntersectionObserver.unobserve es un método de instancia que se llama como observer.unobserve(target). El argumento target debe ser un Element, no un selector. El método devuelve undefined; volver a llamarlo para un elemento que no se está observando no cambia nada.
unobserve(target) separa únicamente el elemento indicado de este observador. disconnect() separa todos sus elementos. Una llamada posterior a observe(target) puede iniciar de nuevo la observación. Un uso habitual es dejar de seguir un elemento después de cargar contenido una sola vez.
Las notificaciones son asíncronas: unobserve(target) no elimina las entradas que ya están en cola ni las que se han pasado a una función callback que se está ejecutando. takeRecords() obtiene y vacía toda la cola del observador, no solo las entradas de ese elemento.
Esta es una API web del navegador, no una función de una edición concreta de ECMAScript. Comprueba su disponibilidad en el navegador de destino; Node 24 en el repositorio no demuestra que sea compatible. El ejemplo inicia y detiene sincrónicamente la observación de un elemento separado del documento, sin depender del desplazamiento.
Ejemplos
(() => {
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();
})();Resultado
true true 0
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.