chrome.idle

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

idle

البيان

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

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

الأنواع

IdleState

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

Enum

"active"

"idle"

"locked"

الطُرق

getAutoLockDelay()

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

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

المعلمات

  • callback

    function اختياري

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

    (delay: number) => void

    • تأخير

      الرقم

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

المرتجعات

  • <number>

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

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

queryState()

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

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

المعلمات

  • detectionIntervalInSeconds

    الرقم

    يُعتبر النظام غير نشط إذا انقضت ثوانٍ من detectionIntervalInSeconds منذ آخر إدخال تم رصده من المستخدم.

  • callback

    function اختياري

    تظهر المَعلمة 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,
)

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

المعلمات

  • callback

    دالة

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

    (newState: IdleState) => void