chrome.idle

refresh date: 2026-09-25 robots: noindex

شرح

از chrome.idle API برای تشخیص زمان تغییر وضعیت غیرفعال دستگاه استفاده کنید.

اجازه‌ها

idle

مانیفست

برای استفاده از میانای برنامه‌سازی کاربردی idle، باید اجازه «idle» را در مانیفست افزونه‌تان اعلام کنید. برای مثال:

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

انواع

IdleState

Chrome نسخه ۴۴ به بالا

شمارشی

«فعال»

«idle»

«قفل‌شده»

روش‌ها

getAutoLockDelay()

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

مدت زمان (به ثانیه) تا قفل شدن خودکار صفحه‌نمایش درحالت غیرفعال را دریافت می‌کند. اگر صفحه هرگز به‌طور خودکار قفل نشود، مدت‌زمان صفر را برمی‌گرداند. درحال‌حاضر فقط در Chrome OS پشتیبانی می‌شود.

پارامترها

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (delay: number) => void

    • تأخیر

      شماره

      زمان (به ثانیه) تا قفل شدن خودکار صفحه درحالت بیکار. اگر صفحه هرگز به‌طور خودکار قفل نشود، این مقدار صفر است.

بازگشتی‌ها

  • Promise<number>

    Chrome نسخه ۱۱۶ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

queryState()

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

اگر سیستم قفل باشد، «قفل‌شده» را برمی‌گرداند، اگر کاربر برای تعداد ثانیه‌های مشخصی هیچ ورودی‌ای تولید نکرده باشد، «بیکار» را برمی‌گرداند، و درغیراین‌صورت «فعال» را برمی‌گرداند.

پارامترها

  • detectionIntervalInSeconds

    شماره

    اگر detectionIntervalInSeconds ثانیه از آخرین ورودی شناسایی‌شده کاربر گذشته باشد، سیستم غیرفعال درنظر گرفته می‌شود.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (newState: IdleState) => void

بازگشتی‌ها

  • Promise<IdleState>

    Chrome نسخه ۱۱۶ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

setDetectionInterval()

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

فاصله زمانی را (به ثانیه) تنظیم می‌کند که برای تعیین زمان قرار گرفتن سیستم در حالت غیرفعال برای رویدادهای onStateChanged استفاده می‌شود. فاصله پیش‌فرض ۶۰ ثانیه است.

پارامترها

  • intervalInSeconds

    شماره

    آستانه، برحسب ثانیه، که برای تعیین زمان قرار گرفتن سیستم در حالت غیرفعال استفاده می‌شود.

رویدادها

onStateChanged

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

وقتی سیستم به حالت فعال، غیرفعال، یا قفل‌شده تغییر می‌کند، فعال می‌شود. اگر صفحه قفل باشد یا محافظ صفحه‌نمایش فعال شود، رویداد با «قفل‌شده» فعال می‌شود، اگر قفل سیستم باز باشد و کاربر برای تعداد ثانیه مشخصی هیچ ورودی‌ای ایجاد نکرده باشد، با «بیکار» فعال می‌شود، و وقتی کاربر در سیستم بیکار ورودی ایجاد کند، با «فعال» فعال می‌شود.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

    (newState: IdleState) => void