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 पर काम करती है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

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

    (delay: number) => void

    • विलंब

      संख्या

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

रिटर्न

  • Promise<number>

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

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

queryState()

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

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

पैरामीटर

  • detectionIntervalInSeconds

    संख्या

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

    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