大网数据广告活动
Web 标准与前端开发

IntersectionObserverEntry: IntersectionObserverEntry() constructor

· 52CE 我爱测

The **`IntersectionObserverEntry()`** constructor creates and returns a new IntersectionObserverEntry object.

Intersection Observer API

The IntersectionObserverEntry() constructor creates and returns a new IntersectionObserverEntry object.

[!NOTE] In typical usage, you don't need to call this constructor yourself. IntersectionObserverEntry objects are created automatically by the browser and delivered to the IntersectionObserver callback when an intersection is observed, or returned by IntersectionObserver.takeRecords().

Syntax

new IntersectionObserverEntry(intersectionObserverEntryInit)

Parameters

  • intersectionObserverEntryInit
    • : An object with the following properties, all of which are required:
      • boundingClientRect
        • : An object specifying the location and dimensions of the target element's bounding rectangle, with x, y, width, and height properties. This corresponds to the rectangle returned by Element.getBoundingClientRect().
      • intersectionRatio
        • : A number representing the ratio of the intersectionRect area to the boundingClientRect area. If the boundingClientRect area is zero, this is 1 if isIntersecting is true, and 0 if not.
      • intersectionRect
        • : An object specifying the location and dimensions of the target's visible area within the root's intersection rectangle, with x, y, width, and height properties.
      • isIntersecting
        • : A boolean value which is true if the target element intersects with the intersection observer's root, or false otherwise.
      • isVisible
        • : A boolean value which is true if the target element has been determined to be fully visible and unoccluded, with no visual effects that would alter its display on screen. A value of false means either that the target has compromised visibility, or that this determination could not be made.
      • rootBounds
        • : An object specifying the location and dimensions of the root's intersection rectangle, with x, y, width, and height properties, or null.
      • target
        • : The Element whose intersection with the root changed.
      • time
        • : A DOMHighResTimeStamp indicating the time at which the intersection was recorded, relative to the IntersectionObserver's time origin.

Return value

A new IntersectionObserverEntry object whose properties are initialized to the values specified in intersectionObserverEntryInit.

Examples

Creating an IntersectionObserverEntry

This example creates a basic IntersectionObserverEntry describing a fully visible element. While you can construct an entry manually like this, in practice these objects are created by the browser and passed to your IntersectionObserver callback automatically.

const entry = new IntersectionObserverEntry({
  time: performance.now(),
  rootBounds: { x: 0, y: 0, width: 1024, height: 768 },
  boundingClientRect: { x: 10, y: 20, width: 200, height: 100 },
  intersectionRect: { x: 10, y: 20, width: 200, height: 100 },
  isIntersecting: true,
  isVisible: false,
  intersectionRatio: 1.0,
  target: document.body,
});

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。