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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.