idle.queryState()

如果系統處於鎖定狀態,則返回 "locked";如果使用者在指定秒數內未產生任何輸入,則返回 "idle";否則返回 "active"

這是一個非同步函式,返回一個 Promise

語法

js
let querying = browser.idle.queryState(
  detectionIntervalInSeconds // integer
)

引數

detectionIntervalInSeconds

integer。如果在檢測到最後一次使用者輸入後經過了 detectionIntervalInSeconds 秒,則認為系統處於空閒狀態。

返回值

一個 Promise,它將以一個 idle.IdleState 字串完成,該字串指示當前狀態。

示例

在此簡單程式碼片段中,我們呼叫 queryState(),然後檢查返回的 newState 是否為 idleactive,並據此記錄一條訊息。因為我們指定了 15 秒的 detectionIntervalInSeconds,所以只有在至少 15 秒內沒有任何使用者活動的情況下,才會報告 idle 狀態。

js
function onGot(newState) {
  if (newState === "idle") {
    console.log("Please come back — we miss you!");
  } else if (newState === "active") {
    console.log("Glad to still have you with us!");
  }
}

let querying = browser.idle.queryState(15);
querying.then(onGot);

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.idle API。此文件源自 Chromium 程式碼中的 idle.json