Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

IntersectionObserver.observe — empezar a observar un elemento

El método observe(target) registra un elemento para seguir de forma asíncrona su intersección con root, según la configuración del observador.

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.observe(target)

observer.observe(target) acepta un Element y devuelve undefined. Volver a registrar el mismo elemento no cambia nada. Un observador puede seguir varios elementos. Configura root, rootMargin y threshold en el constructor, no en observe().

Cuando el navegador evalúa por primera vez el elemento registrado, pone en cola una entrada inicial, incluso si no hay intersección. Las entradas en cola se pasan al callback de forma asíncrona, pero este puede no recibir la entrada inicial: unobserve(target) puede detener la observación antes de que se genere la entrada y takeRecords() puede retirarla de la cola antes de que se entregue. Si se cruza un umbral o cambia isIntersecting, se puede poner en cola una nueva entrada. El callback recibe un array de entradas. Una intersección geométrica no demuestra que los píxeles sean realmente visibles.

unobserve(target) deja de seguir un elemento, mientras que disconnect() deja de seguirlos todos. Esta es una API Web del navegador, no una función de una edición concreta de ECMAScript. Comprueba su disponibilidad en el entorno de destino. Node 24 por sí solo no confirma que sea compatible.

Ejemplos

(() => {
  if (!("IntersectionObserver" in window)) {
    throw new Error("IntersectionObserver is unavailable");
  }

  const target = document.createElement("div");
  target.style.display = "none";
  document.body.append(target);

  const observer = new IntersectionObserver((entries) => {
    console.log("initial:", entries[0].isIntersecting);
    observer.disconnect();
    target.remove();
  });

  observer.observe(target);
  observer.observe(target);
  console.log("started");
})();

Resultado

started
initial: false

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.

Fuentes