chrome.idle

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم واجهة برمجة التطبيقات chrome.idle لرصد التغيّرات في حالة عدم النشاط على الجهاز.

الأذونات

idle

البيان

يجب الإفصاح عن إذن "الوضع غير النشط" في بيان الإضافة لاستخدام واجهة برمجة التطبيقات الخاصة بالوضع غير النشط. على سبيل المثال:

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

الأنواع

IdleState

Chrome 44 والإصدارات الأحدث

تعداد

"active"

"idle"

"locked"

الطُرق

getAutoLockDelay()

Promise الإصدار 73 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

تعرض هذه السمة الوقت بالثواني الذي يستغرقه قفل الشاشة تلقائيًا أثناء عدم استخدامها. تعرِض هذه السمة مدة صفرية إذا لم يتم قفل الشاشة تلقائيًا مطلقًا. تتوفّر هذه الميزة حاليًا على نظام التشغيل Chrome فقط.

المعلمات

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (delay: number) => void

    • تأخير

      الرقم

      الوقت بالثواني حتى يتم قفل الشاشة تلقائيًا أثناء الخمول القيمة هي صفر إذا لم يتم قفل الشاشة تلقائيًا أبدًا.

المرتجعات

  • Promise<number>

    الإصدار 116 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

queryState()

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

تعرض القيمة "locked" إذا كان النظام مقفلاً، أو "idle" إذا لم يُدخل المستخدم أي بيانات لعدد محدّد من الثواني، أو "active" في الحالات الأخرى.

المعلمات

  • detectionIntervalInSeconds

    الرقم

    يُعدّ النظام غير نشط إذا مرّت detectionIntervalInSeconds ثانية منذ آخر إدخال رصده المستخدم.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (newState: IdleState) => void

المرتجعات

  • Promise<IdleState>

    الإصدار 116 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

setDetectionInterval()

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

تضبط هذه السمة الفاصل الزمني بالثواني المستخدَم لتحديد الوقت الذي يكون فيه النظام في حالة عدم نشاط لأحداث onStateChanged. الفاصل الزمني التلقائي هو 60 ثانية.

المعلمات

  • intervalInSeconds

    الرقم

    الحدّ الأدنى، بالثواني، المستخدَم لتحديد الوقت الذي يكون فيه النظام في حالة عدم نشاط

الفعاليات

onStateChanged

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

يتم تنشيط هذا الحدث عندما تتغيّر حالة النظام إلى نشطة أو غير نشطة أو مقفلة. يتم تشغيل الحدث مع القيمة "locked" إذا كانت الشاشة مقفلة أو تم تفعيل صورة شاشة الاستراحة، والقيمة "idle" إذا كان النظام غير مقفل ولم يُدخل المستخدم أي بيانات لعدد محدّد من الثواني، والقيمة "active" عندما يُدخل المستخدم بيانات على نظام غير نشط.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (newState: IdleState) => void