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

IdleDetector

· 52CE 我爱测

The **`IdleDetector`** interface of the idle_detection_api provides methods and events for detecting user activity on a device or screen.

Idle Detection APIwindow_and_dedicated

The IdleDetector interface of the idle_detection_api provides methods and events for detecting user activity on a device or screen.

This interface requires a secure context.

Constructor

  • IdleDetector.IdleDetector
    • : Creates a new IdleDetector object.

Instance properties

  • IdleDetector.userState
    • : Returns a string indicating whether the users has interacted with either the screen or the device within the threshold provided to start(), one of "active" or "idle". This attribute returns null before start() is called.
  • IdleDetector.screenState
    • : Returns a string indicating whether the screen is locked, one of "locked" or "unlocked". This attribute returns null before start() is called.

Static methods

  • IdleDetector/requestPermission_static
    • : Returns a Promise that resolves when the user has chosen whether to grant the origin access to their idle state. Resolves with "granted" on acceptance and "denied" on refusal.

Instance methods

  • IdleDetector.start()
    • : Returns a Promise that resolves when the detector starts listening for changes in the user's idle state. userState and screenState are given initial values. This method takes an optional options object with the threshold in milliseconds where inactivity should be reported and signal for an AbortSignal to abort the idle detector.

Events

  • IdleDetector.change_event
    • : Called when the value of userState or screenState has changed.

Examples

The following example shows creating a detector and logging changes to the user's idle state. A button is used to get the necessary user activation before requesting permission.

const controller = new AbortController();
const signal = controller.signal;

startButton.addEventListener("click", async () => {
  if ((await IdleDetector.requestPermission()) !== "granted") {
    console.error("Idle detection permission denied.");
    return;
  }

  try {
    const idleDetector = new IdleDetector();
    idleDetector.addEventListener("change", () => {
      const userState = idleDetector.userState;
      const screenState = idleDetector.screenState;
      console.log(`Idle change: ${userState}, ${screenState}.`);
    });

    await idleDetector.start({
      threshold: 60_000,
      signal,
    });
    console.log("IdleDetector is active.");
  } catch (err) {
    // Deal with initialization errors like permission denied,
    // running outside of top-level frame, etc.
    console.error(err.name, err.message);
  }
});

stopButton.addEventListener("click", () => {
  controller.abort();
  console.log("IdleDetector is stopped.");
});

Specifications

Browser compatibility

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

资料来源与适用范围

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

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

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