chrome.idle

תאריך הרענון: 2026-09-25 robots: noindex

תיאור

אפשר להשתמש ב-chrome.idle API כדי לזהות מתי משתנה מצב חוסר הפעילות של המחשב.

הרשאות

idle

מניפסט

כדי להשתמש ב-API של מצב חוסר פעילות, צריך להצהיר על ההרשאה 'מצב חוסר פעילות' במניפסט של התוסף. לדוגמה:

{
  "name": "My extension",
  ...
  "permissions": [
    "idle"
  ],
  ...
}

סוגים

IdleState

‫Chrome 44 ואילך

ספירה

'פעיל'

'idle'

‫'locked'

Methods

getAutoLockDelay()

Promise Chrome 73+ ChromeOS only 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

מקבל את הזמן בשניות שצריך לעבור עד שהמסך יינעל אוטומטית בזמן שהמכשיר לא פעיל. הפונקציה מחזירה משך זמן של אפס אם המסך אף פעם לא ננעל אוטומטית. בשלב הזה יש תמיכה רק ב-ChromeOS.

פרמטרים

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (delay: number) => void

    • עיכוב

      number

      הזמן בשניות עד שהמסך יינעל אוטומטית בזמן שהמכשיר לא פעיל. הערך הוא אפס אם המסך אף פעם לא ננעל אוטומטית.

החזרות

  • Promise<number>

    ‫Chrome 116 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

queryState()

Promise 
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
): Promise<IdleState>

הפונקציה מחזירה את הערך locked אם המערכת נעולה, את הערך idle אם המשתמש לא הזין קלט במשך מספר שניות שצוין, או את הערך active בכל מקרה אחר.

פרמטרים

  • detectionIntervalInSeconds

    number

    המערכת נחשבת לא פעילה אם חלפו detectionIntervalInSeconds שניות מאז קלט המשתמש האחרון שזוהה.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (newState: IdleState) => void

החזרות

  • Promise<IdleState>

    ‫Chrome 116 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
): void

מגדיר את פרק הזמן, בשניות, שמשמש לקביעה מתי המערכת במצב בלי פעילות עבור אירועים מסוג onStateChanged. ברירת המחדל של המרווח היא 60 שניות.

פרמטרים

  • intervalInSeconds

    number

    סף, בשניות, שמשמש לקביעה מתי המערכת במצב בלי פעילות.

אירועים

onStateChanged

chrome.idle.onStateChanged.addListener(
  callback: function,
)

האירוע מופעל כשהמערכת משתנה למצב פעיל, למצב בלי פעילות או למצב נעול. האירוע מופעל עם הערך locked אם המסך נעול או אם שומר המסך מופעל, עם הערך idle אם המערכת לא נעולה והמשתמש לא הזין קלט במשך מספר שניות שצוין, ועם הערך active אם המשתמש מזין קלט במערכת לא פעילה.

פרמטרים

  • callback

    פונקציה

    הפרמטר callback נראה כך: 

    (newState: IdleState) => void