chrome.idle

refresh date: 2026-09-25 robots: noindex

תיאור

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

הרשאות

idle

מניפסט

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

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

סוגים

IdleState

‫Chrome מגרסה 44 ואילך

טיפוסים בני מנייה (enum)

"active"

"idle"

"locked"

Methods

getAutoLockDelay()

Promise Chrome 73+‎ ChromeOS בלבד 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

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

פרמטרים

  • callback

    function optional

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

    (delay: number) => void

    • עיכוב

      number

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

החזרות

  • Promise<number>

    ‫Chrome מגרסה 116 ואילך

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

queryState()

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

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

פרמטרים

  • detectionIntervalInSeconds

    number

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

  • callback

    function optional

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

    (newState: IdleState) => void

החזרות

  • Promise<IdleState>

    ‫Chrome מגרסה 116 ואילך

    הבטחות נתמכות רק ב-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