تاریخ به‌روزرسانی: 2026-09-25 ربات‌ها: noindex
توضیحات
از API chrome.idle برای تشخیص زمان تغییر حالت بیکاری دستگاه استفاده کنید.
مجوزها
idleمانیفست
برای استفاده از API مربوط به حالت idle، باید مجوز "idle" را در مانیفست افزونه خود اعلام کنید. برای مثال:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
انواع
IdleState
شمارشی
"فعال" "بیکار" "قفل شده"
روش‌ها
getAutoLockDelay()
chrome.idle.getAutoLockDelay(
callback?: function,
): Promise<number>
زمان لازم برای قفل شدن خودکار صفحه نمایش در حالت غیرفعال (به ثانیه) را برمی‌گرداند. اگر صفحه نمایش هرگز به طور خودکار قفل نشود، مدت زمان صفر را برمی‌گرداند. در حال حاضر فقط در سیستم عامل کروم پشتیبانی می‌شود.
پارامترها
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:(delay: number) => void
- تأخیر
شماره
زمان، بر حسب ثانیه، تا زمانی که صفحه نمایش در حالت غیرفعال به طور خودکار قفل شود. اگر صفحه نمایش هرگز به طور خودکار قفل نشود، این مقدار صفر است.
بازگشت‌ها
قول<number>
کروم ۱۱۶+Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.
queryState()
chrome.idle.queryState(
detectionIntervalInSeconds: number,
callback?: function,
): Promise<IdleState>
اگر سیستم قفل شده باشد، "قفل شده" را برمی‌گرداند، اگر کاربر برای مدت زمان مشخصی (بر حسب ثانیه) هیچ ورودی ایجاد نکرده باشد، "بیکار" را برمی‌گرداند، و در غیر این صورت "فعال" را برمی‌گرداند.
پارامترها
- تشخیصفاصلهدرثانیه
شماره
اگر از آخرین ورودی کاربر که توسط detectionIntervalInSeconds شناسایی شده، ثانیه گذشته باشد، سیستم بیکار در نظر گرفته می‌شود.
- تماس برگشتی
تابع اختیاری
پارامتر
callbackبه شکل زیر است:(newState: IdleState) => void
- ایالت جدید
بازگشت‌ها
قول< IdleState >
کروم ۱۱۶+Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.
setDetectionInterval()
chrome.idle.setDetectionInterval(
intervalInSeconds: number,
): void
فاصله زمانی (بر حسب ثانیه) را تنظیم می‌کند که برای تعیین زمان بیکار بودن سیستم برای رویدادهای onStateChanged استفاده می‌شود. فاصله زمانی پیش‌فرض ۶۰ ثانیه است.
پارامترها
- بازه زمانی در ثانیه
شماره
آستانه، بر حسب ثانیه، برای تعیین زمان بیکار بودن سیستم استفاده می‌شود.
رویدادها
onStateChanged
chrome.idle.onStateChanged.addListener(
callback: function,
)
زمانی که سیستم به حالت فعال، غیرفعال یا قفل شده تغییر می‌کند، این رویداد با "locked" (قفل شده) فعال می‌شود اگر صفحه نمایش قفل شده باشد یا محافظ صفحه نمایش فعال شود، "idle" (بیکار) اگر سیستم قفل نشده باشد و کاربر برای مدت زمان مشخصی هیچ ورودی ایجاد نکرده باشد، و "active" (فعال) زمانی فعال می‌شود که کاربر در یک سیستم غیرفعال ورودی ایجاد کند.
پارامترها
- تماس برگشتی
تابع
پارامتر
callbackبه شکل زیر است:(newState: IdleState) => void
- ایالت جدید