chrome.types

ब्यौरा

chrome.types API में, Chrome के लिए टाइप की जानकारी का इस्तेमाल किया जाता है.

Chrome सेटिंग

ChromeSetting प्रोटोटाइप, फ़ंक्शन का एक सामान्य सेट (get(), set(), और clear()) देता है और साथ ही Chrome ब्राउज़र की सेटिंग के लिए एक इवेंट प्रकाशक (onChange) शामिल है. प्रॉक्सी सेटिंग उदाहरणों से पता चलता है कि इन फ़ंक्शन का इस्तेमाल कैसे किया जाना चाहिए.

दायरा और लाइफ़ साइकल

Chrome, ब्राउज़र सेटिंग के तीन अलग-अलग दायरों के बीच अंतर करता है:

regular

regular दायरे में सेट की गई सेटिंग सामान्य ब्राउज़र विंडो पर लागू होती हैं और गुप्त मोड से इनहेरिट की जाती हैं Windows. ये सेटिंग डिस्क पर सेव की जाती हैं और तब तक बनी रहेंगी उन्हें नियंत्रण करने वाले एक्सटेंशन से हटा दिया जाता है या नियंत्रण करने वाले एक्सटेंशन को बंद या अनइंस्टॉल कर दिया जाता है.

incognito_persistent

incognito_persistent दायरे में सेट की गई सेटिंग सिर्फ़ गुप्त विंडो पर लागू होती हैं. इनके लिए, वे regular सेटिंग बदलें. ये सेटिंग, डिस्क में सेव की जाती हैं. साथ ही, ये तब तक लागू रहती हैं, जब तक ये सेटिंग चालू नहीं होतीं नियंत्रण करने वाले एक्सटेंशन से हटाया जा सकता है या नियंत्रण करने वाले एक्सटेंशन को बंद या अनइंस्टॉल कर दिया गया है.

incognito_session_only

incognito_session_only दायरे में सेट की गई सेटिंग सिर्फ़ गुप्त विंडो पर लागू होती हैं. इनके लिए, वे regular और incognito_persistent सेटिंग बदलें. ये सेटिंग डिस्क पर संग्रहित नहीं की जाती हैं और आखिरी गुप्त विंडो के बंद होने पर मिटा दिए जाते हैं. इन्हें सिर्फ़ तब सेट किया जा सकता है, जब कम से कम एक हो गुप्त विंडो खुली है.

प्राथमिकता

Chrome अलग-अलग लेयर पर सेटिंग मैनेज करता है. नीचे दी गई सूची में उन लेयर के बारे में बताया गया है जो प्राथमिकता के बढ़ते क्रम में, प्रभावी सेटिंग पर असर डालती हैं.

1. ऑपरेटिंग सिस्टम से मिली सिस्टम सेटिंग
2. कमांड लाइन पैरामीटर
3. एक्सटेंशन से मिली सेटिंग
4. नीतियां

जैसा कि सूची में बताया गया है, नीतियां आपके एक्सटेंशन में बताए गए किसी भी बदलाव को खारिज कर सकती हैं. आपने लोगों तक पहुंचाया मुफ़्त में get() फ़ंक्शन का इस्तेमाल करके यह पता कर सकता है कि आपका एक्सटेंशन सेटिंग दे सकता है या नहीं या क्या इस सेटिंग को बदला जाएगा.

जैसा कि ऊपर बताया गया है, Chrome, रेगुलर विंडो और गुप्त मोड के लिए अलग-अलग सेटिंग इस्तेमाल करने की अनुमति देता है विंडो. यह उदाहरण व्यवहार दिखाता है. मान लें कि कोई भी नीति सेटिंग लागू कर सकते हैं और एक्सटेंशन, रेगुलर विंडो (R) के लिए सेटिंग और गुप्त विंडो (I).

• अगर सिर्फ़ (R) को सेट किया गया है, तो ये सेटिंग सामान्य और गुप्त विंडो, दोनों पर लागू होती हैं.
• अगर सिर्फ़ (I) सेट है, तो ये सेटिंग सिर्फ़ गुप्त विंडो के लिए लागू होंगी. नियमित विंडो निचली लेयर (कमांड-लाइन के विकल्प और सिस्टम सेटिंग) की मदद से तय की गई सेटिंग का इस्तेमाल करें.
• अगर (R) और (I), दोनों सेट हैं, तो सामान्य और गुप्त मोड के लिए, संबंधित सेटिंग का इस्तेमाल किया जाता है विंडो.

अगर दो या ज़्यादा एक्सटेंशन एक ही सेटिंग को अलग-अलग वैल्यू पर सेट करना चाहते हैं, तो सबसे हाल ही में अन्य एक्सटेंशन को प्राथमिकता दी जाती है. अगर सबसे हाल ही में इंस्टॉल किया गया एक्सटेंशन सिर्फ़ (I) सेट करता है, तो रेगुलर विंडो की सेटिंग को पहले से इंस्टॉल किए गए एक्सटेंशन से तय किया जा सकता है एक्सटेंशन.

किसी सेटिंग की असरदार वैल्यू वह वैल्यू होती है जो प्राथमिकता के नियमों को ध्यान में रखकर दी जाती है. यह का इस्तेमाल Chrome करता है.

टाइप

ChromeSetting

ऐसा इंटरफ़ेस जो Chrome ब्राउज़र की सेटिंग को ऐक्सेस करने की अनुमति देता है. उदाहरण के लिए accessibilityFeatures देखें.

प्रॉपर्टी

• onChange

  इवेंट<Functionvoid>

  सेटिंग में बदलाव होने के बाद सक्रिय होता है.

  onChange.addListener फ़ंक्शन इस तरह दिखता है:

  (callback: function) => {...}

  • कॉलबैक

    फ़ंक्शन

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

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • incognitoSpecific

        बूलियन ज़रूरी नहीं

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

      • levelOfControl

        LevelOfControl

        सेटिंग के लिए कंट्रोल का लेवल.

      • value

        T

        बदलाव के बाद सेटिंग का मान.

• मिटाएं

  अमान्य

  प्रॉमिस

  सेटिंग हटाता है और कोई भी डिफ़ॉल्ट वैल्यू वापस ला देता है.

  clear फ़ंक्शन इस तरह दिखता है:

  (details: object, callback?: function) => {...}

  • विवरण

    ऑब्जेक्ट

    किस सेटिंग को हटाना है.

    • दायरा

      ChromeSettingScope वैकल्पिक

      सेटिंग को कहां हटाएं (डिफ़ॉल्ट: सामान्य).

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    () => void

  • returns

    प्रॉमिस<void>

    Chrome 96 और उसके बाद के वर्शन

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

• रिवॉर्ड पाएँ

  अमान्य

  प्रॉमिस

  किसी सेटिंग की वैल्यू पता करता है.

  get फ़ंक्शन इस तरह दिखता है:

  (details: object, callback?: function) => {...}

  • विवरण

    ऑब्जेक्ट

    आपको कौनसी सेटिंग चुननी है.

    • गुप्त मोड

      बूलियन ज़रूरी नहीं

      क्या गुप्त मोड वाले सेशन पर लागू होने वाली वैल्यू देनी है (डिफ़ॉल्ट रूप से गलत).

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      मौजूदा समय में लागू होने वाली वैल्यू की जानकारी.

      • incognitoSpecific

        बूलियन ज़रूरी नहीं

        असरदार वैल्यू, खास तौर पर गुप्त मोड वाले सेशन के लिए है या नहीं. यह प्रॉपर्टी सिर्फ़ तब दिखेगी, जब get() के details पैरामीटर में मौजूद incognito प्रॉपर्टी सही हो.

      • levelOfControl

        LevelOfControl

        सेटिंग के कंट्रोल का लेवल.

      • value

        T

        सेटिंग की वैल्यू.

  • returns

    Promise&lt;object&gt;

    Chrome 96 और उसके बाद के वर्शन

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

• सेट करो

  अमान्य

  प्रॉमिस

  किसी सेटिंग की वैल्यू सेट करता है.

  set फ़ंक्शन इस तरह दिखता है:

  (details: object, callback?: function) => {...}

  • विवरण

    ऑब्जेक्ट

    किस सेटिंग को बदलना है.

    • दायरा

      ChromeSettingScope वैकल्पिक

      सेटिंग कहां सेट करें (डिफ़ॉल्ट: नियमित).

    • value

      T

      सेटिंग की वैल्यू. ध्यान दें कि हर सेटिंग का एक खास वैल्यू टाइप होता है, जिसके बारे में सेटिंग के साथ बताया जाता है. एक्सटेंशन को किसी अलग तरह का मान सेट नहीं करना चाहिए.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    () => void

  • returns

    प्रॉमिस<void>

    Chrome 96 और उसके बाद के वर्शन

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

ChromeSettingScope

Chrome 44 और उसके बाद वाले वर्शन के लिए

ChromeSettings का दायरा. इनमें से एक

• regular: सामान्य प्रोफ़ाइल की सेटिंग (जो कहीं और न बदले जाने पर, गुप्त प्रोफ़ाइल से इनहेरिट की जाती है),
• regular\_only: सिर्फ़ सामान्य प्रोफ़ाइल के लिए सेटिंग (गुप्त प्रोफ़ाइल से नहीं ली गई),
• incognito\_persistent: ब्राउज़र के रीस्टार्ट होने पर, गुप्त प्रोफ़ाइल की सेटिंग चालू रहती है (सामान्य सेटिंग बदल जाती हैं),
• incognito\_session\_only: गुप्त प्रोफ़ाइल की वह सेटिंग जिसे सिर्फ़ गुप्त मोड वाले सेशन के दौरान सेट किया जा सकता है. साथ ही, गुप्त मोड वाले सेशन के खत्म होने पर मिटा दी जाती है. यह सामान्य और गुप्त_पर्सिस्टेंट प्राथमिकताओं को बदल देती है.

Enum

"सामान्य"

"regular_only"

"गुप्त_पर्सिस्टेंट"

"गुप्त_session_only"

LevelOfControl

Chrome 44 और उसके बाद वाले वर्शन के लिए

इनमें से एक

• not\_controllable: इसे किसी भी एक्सटेंशन के ज़रिए कंट्रोल नहीं किया जा सकता
• controlled\_by\_other\_extensions: इसे ज़्यादा प्राथमिकता वाले एक्सटेंशन से कंट्रोल किया जाता है
• controllable\_by\_this\_extension: इसे इस एक्सटेंशन से कंट्रोल किया जा सकता है
• controlled\_by\_this\_extension: इस एक्सटेंशन के ज़रिए कंट्रोल किया जाता है

Enum

"not_controllable"

&quot;controlled_by_other_extensions&quot;

&quot;controllable_by_this_extension&quot;

&quot;controlled_by_this_extension&quot;