chrome.idle

ब्यौरा

मशीन के आइडल मोड में बदलाव होने का पता लगाने के लिए, 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>

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

पैरामीटर

  • कॉलबैक

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

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

    (delay: number) => void

    • विलंब

      संख्या

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

रिटर्न

  • Promise<number>

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

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

queryState()

प्रॉमिस 
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
): Promise<IdleState>

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

पैरामीटर

  • detectionIntervalInSeconds

    संख्या

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

  • कॉलबैक

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

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

    (newState: IdleState) => void

रिटर्न

  • Promise<IdleState>

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

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट 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