chrome.idle

refresh date: 2026-09-25 robots: noindex

ब्यौरा

chrome.idle एपीआई का इस्तेमाल करके, यह पता लगाएं कि मशीन की आइडल स्टेट कब बदलती है.

अनुमतियां

idle

मेनिफ़ेस्ट

Idle API का इस्तेमाल करने के लिए, आपको अपने एक्सटेंशन के मेनिफ़ेस्ट में "idle" अनुमति का एलान करना होगा. उदाहरण के लिए:

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

टाइप

IdleState

Chrome 44 या इसके बाद का वर्शन

Enum

"active"

"idle"

"locked"

तरीके

getAutoLockDelay()

Promise Chrome 73 और इसके बाद के वर्शन सिर्फ़ ChromeOS 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

इससे, डिवाइस का इस्तेमाल न होने पर, स्क्रीन के अपने-आप लॉक होने में लगने वाले समय का पता चलता है. यह समय सेकंड में होता है. अगर स्क्रीन कभी भी अपने-आप लॉक नहीं होती है, तो शून्य दिखाता है. फ़िलहाल, यह सुविधा सिर्फ़ ChromeOS पर काम करती है.

पैरामीटर

  • कॉलबैक

    function ज़रूरी नहीं

    callback पैरामीटर कुछ ऐसा दिखता है: 

    (delay: number) => void

    • विलंब

      संख्या

      डिवाइस का इस्तेमाल न होने पर, स्क्रीन अपने-आप लॉक होने में लगने वाला समय, सेकंड में. अगर स्क्रीन कभी भी अपने-आप लॉक नहीं होती है, तो यह वैल्यू शून्य होती है.

रिटर्न

  • Promise<number>

    Chrome 116 या इसके बाद का वर्शन

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

queryState()

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

अगर सिस्टम लॉक है, तो "लॉक है" दिखाता है. अगर उपयोगकर्ता ने तय किए गए सेकंड तक कोई इनपुट जनरेट नहीं किया है, तो "कुछ नहीं कर रहा है" दिखाता है. इसके अलावा, "चालू है" दिखाता है.

पैरामीटर

  • detectionIntervalInSeconds

    संख्या

    अगर उपयोगकर्ता के आखिरी इनपुट के बाद, detectionIntervalInSeconds सेकंड बीत चुके हैं, तो सिस्टम को इस्तेमाल में नहीं माना जाता.

  • कॉलबैक

    function ज़रूरी नहीं

    callback पैरामीटर कुछ ऐसा दिखता है: 

    (newState: IdleState) => void

रिटर्न

  • Promise<IdleState>

    Chrome 116 या इसके बाद का वर्शन

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

setDetectionInterval()

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

यह नीति, सेकंड में वह इंटरवल सेट करती है जिसका इस्तेमाल यह तय करने के लिए किया जाता है कि onStateChanged इवेंट के लिए, सिस्टम कब इस्तेमाल में नहीं है. डिफ़ॉल्ट इंटरवल 60 सेकंड है.

पैरामीटर

  • intervalInSeconds

    संख्या

    सिस्टम के इस्तेमाल में न होने की स्थिति का पता लगाने के लिए, सेकंड में थ्रेशोल्ड.

इवेंट

onStateChanged

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

यह इवेंट तब ट्रिगर होता है, जब सिस्टम चालू, इस्तेमाल में नहीं या लॉक की गई स्थिति में बदलता है. अगर स्क्रीन लॉक है या स्क्रीन सेवर चालू है, तो इवेंट "locked" के साथ ट्रिगर होता है. अगर सिस्टम अनलॉक है और उपयोगकर्ता ने तय किए गए सेकंड तक कोई इनपुट जनरेट नहीं किया है, तो इवेंट "idle" के साथ ट्रिगर होता है. अगर उपयोगकर्ता किसी बंद सिस्टम पर इनपुट जनरेट करता है, तो इवेंट "active" के साथ ट्रिगर होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर कुछ ऐसा दिखता है: 

    (newState: IdleState) => void