IdleDetector: start() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

注意:此功能在 專用 Web Workers 中可用。

start() 方法是 IdleDetector 介面的一個方法,它返回一個 Promise,當檢測器開始監聽使用者空閒狀態的變化時,該 Promise 會被解析。此方法接受一個可選的 options 物件,其中包含一個 threshold(以毫秒為單位,表示多久不活動後應報告)和一個用於中止空閒檢測的 AbortSignalsignal

語法

js
start()
start(options)

引數

options 可選

具有以下屬性的物件:

threshold

開始報告應開始之前的最短空閒毫秒數。

signal

指向 AbortSignal 例項的引用,允許您中止空閒檢測。

返回值

Promise

異常

NotAllowedError DOMException

此功能的使用被 Permissions Policy 阻止了。

示例

以下示例展示瞭如何使用 options 引數啟動空閒檢測。它從 AbortController 例項中檢索 AbortSignal 例項。

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

await idleDetector.start({
  threshold: 60_000,
  signal,
});
console.log("IdleDetector is active.");

規範

規範
空閒檢測 API
# api-idledetector-start

瀏覽器相容性