База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

IntersectionObserver.observe — започване на наблюдение на елемент

Методът observe(target) регистрира елемент за асинхронно проследяване на пресичането му с root според конфигурацията на наблюдателя.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

observer.observe(target)

observer.observe(target) приема Element и връща undefined. Повторното регистриране на същия елемент не променя нищо. Един наблюдател може да следи множество елементи. Задайте root, rootMargin и threshold в конструктора, а не в observe().

Когато браузърът провери регистрирания елемент за първи път, той добавя начален запис в опашката, дори когато няма пресичане. Записите от опашката се предават асинхронно на callback функцията, но тя може да не получи началния запис: unobserve(target) може да спре наблюдението, преди записът да бъде създаден, а takeRecords() може да го извади от опашката, преди да бъде предаден. Преминаването на праг или промяна в isIntersecting може да доведе до добавяне на нов запис в опашката. Callback функцията получава масив от записи. Геометричното пресичане не доказва, че пикселите действително са видими.

unobserve(target) спира следенето на един елемент, а disconnect() спира следенето на всички. Това е уеб API на браузъра, а не функция на конкретно издание на ECMAScript. Проверете наличността в целевата среда. Сам по себе си Node 24 не доказва, че има поддръжка.

Примери

(() => {
  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");
})();

Резултат

started
initial: false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници