IntersectionObserverEntry

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

The IntersectionObserverEntry interface of the Intersection Observer API describes the intersection between the target element and its root container at a specific moment of transition. Instances of IntersectionObserverEntry are delivered to an IntersectionObserver callback in its entries parameter; otherwise, these objects can only be obtained by calling IntersectionObserver.takeRecords().

Properties

IntersectionObserverEntry.boundingClientRect Read only
Returns the bounds rectangle of the target element as a DOMRectReadOnly. The bounds are computed as described in the documentation for Element.getBoundingClientRect().
IntersectionObserverEntry.intersectionRatio Read only
Returns the ratio of the intersectionRect to the boundingClientRect.
IntersectionObserverEntry.intersectionRect Read only
Returns a DOMRectReadOnly representing the target's visible area.
IntersectionObserverEntry.isIntersecting Read only
A Boolean value which is true if the target element intersects with the intersection observer's root. If this is true, then, the IntersectionObserverEntry describes a transition into a state of intersection; if it's false, then you know the transition is from intersecting to not-intersecting.
IntersectionObserverEntry.rootBounds Read only
Returns a DOMRectReadOnly for the intersection observer's root.
IntersectionObserverEntry.target Read only
The Element whose intersection with the root changed.
IntersectionObserverEntry.time Read only
A DOMHighResTimeStamp indicating the time at which the intersection was recorded, relative to the IntersectionObserver's time origin.

Methods

This interface has no methods.

Specifications

Specification Status Comment
Intersection Observer
The definition of 'IntersectionObserverEntry' in that specification.
Editor's Draft Initial definition

Browser compatibility

FeatureChromeFirefoxEdgeInternet ExplorerOperaSafari
boundingClientRect51

53 — 55

55

15(No)??
intersectionRatio51

53 — 55

55

15(No)??
intersectionRect51

53 — 55

55

15(No)??
isIntersecting51

53 — 55

55

15(No)??
rootBounds51

53 — 55

55

15(No)??
target51

53 — 55

55

15(No)??
time51

53 — 55

55

15(No)??
FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
boundingClientRect5151(Yes)?(No)??
intersectionRatio5151(Yes)?(No)??
intersectionRect5151(Yes)?(No)??
isIntersecting5151(Yes)?(No)??
rootBounds5151(Yes)?(No)??
target5151(Yes)?(No)??
time5151(Yes)?(No)??

Document Tags and Contributors

 Last updated by: fscholz,