chrome.privacy

refresh date: 2026-09-25 robots: noindex

ब्यौरा

Chrome में मौजूद उन सुविधाओं के इस्तेमाल को कंट्रोल करने के लिए, chrome.privacy API का इस्तेमाल करें जिनसे किसी व्यक्ति की निजता पर असर पड़ सकता है. Chrome के कॉन्फ़िगरेशन को पाने और सेट करने के लिए, यह एपीआई ChromeSetting prototype of the type API पर निर्भर करता है.

अनुमतियां

privacy

मेनिफ़ेस्ट

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

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

इस्तेमाल

Chrome की किसी सेटिंग की मौजूदा वैल्यू को पढ़ना आसान है. आपको सबसे पहले वह प्रॉपर्टी ढूंढनी होगी जिसमें आपकी दिलचस्पी है. इसके बाद, आपको उस ऑब्जेक्ट पर get() को कॉल करना होगा, ताकि उसकी मौजूदा वैल्यू और आपके एक्सटेंशन के कंट्रोल का लेवल वापस पाया जा सके. उदाहरण के लिए, यह पता लगाने के लिए कि Chrome में अपने-आप भरने की सुविधा चालू है या नहीं, आपको यह लिखना होगा:

chrome.privacy.services.autofillEnabled.get({}, function(details) {
  if (details.value) {
    console.log('Autofill is on!');
  } else {
    console.log('Autofill is off!');
  }
});

किसी सेटिंग की वैल्यू बदलना थोड़ा मुश्किल है. इसकी वजह यह है कि आपको पहले यह पुष्टि करनी होगी कि आपका एक्सटेंशन सेटिंग को कंट्रोल कर सकता है. अगर आपका एक्सटेंशन ऐसी सेटिंग को टॉगल करता है जो एंटरप्राइज़ नीतियों के तहत किसी खास वैल्यू पर लॉक है (levelOfControl को "not_controllable" पर सेट किया जाएगा) या अगर कोई दूसरा एक्सटेंशन वैल्यू को कंट्रोल कर रहा है (levelOfControl को "controlled_by_other_extensions" पर सेट किया जाएगा), तो उपयोगकर्ता को अपनी सेटिंग में कोई बदलाव नहीं दिखेगा. set() कॉल हो जाएगा, लेकिन सेटिंग तुरंत बदल जाएगी. यह भ्रम की स्थिति पैदा कर सकता है. इसलिए, हमारा सुझाव है कि जब उपयोगकर्ता की चुनी गई सेटिंग लागू न हों, तो उसे चेतावनी दी जाए.

इसका मतलब है कि आपको get() तरीके का इस्तेमाल करके, अपने ऐक्सेस लेवल का पता लगाना चाहिए. इसके बाद, सिर्फ़ तब set() को कॉल करें, जब आपका एक्सटेंशन सेटिंग पर कंट्रोल कर सकता हो. अगर आपका एक्सटेंशन सेटिंग को कंट्रोल नहीं कर सकता, तो उपयोगकर्ता के भ्रम को कम करने के लिए, इस सुविधा को विज़ुअल तौर पर बंद करना बेहतर होगा:

chrome.privacy.services.autofillEnabled.get({}, function(details) {
  if (details.levelOfControl === 'controllable_by_this_extension') {
    chrome.privacy.services.autofillEnabled.set({ value: true }, function() {
      if (chrome.runtime.lastError === undefined) {
        console.log("Hooray, it worked!");
      } else {
        console.log("Sadness!", chrome.runtime.lastError);
      }
    });
  }
});

अगर आपको किसी सेटिंग की वैल्यू में हुए बदलावों के बारे में जानना है, तो उसके onChange इवेंट में एक लिसनर जोड़ें. इसके अलावा, इस सुविधा का इस्तेमाल कई अन्य कामों के लिए भी किया जा सकता है. जैसे, अगर हाल ही में इंस्टॉल किया गया कोई एक्सटेंशन, किसी सेटिंग का कंट्रोल अपने पास ले लेता है या एंटरप्राइज़ नीति आपके कंट्रोल को बदल देती है, तो आपको उपयोगकर्ता को इसकी सूचना देने का विकल्प मिलेगा. उदाहरण के लिए, Autofill के स्टेटस में होने वाले बदलावों को सुनने के लिए, यहां दिया गया कोड काफ़ी होगा:

chrome.privacy.services.autofillEnabled.onChange.addListener(
  function (details) {
    // The new value is stored in `details.value`, the new level of control
    // in `details.levelOfControl`, and `details.incognitoSpecific` will be
    // `true` if the value is specific to Incognito mode.
  }
);

उदाहरण

इस एपीआई को आज़माने के लिए, chrome-extension-samples रिपॉज़िटरी से privacy API example इंस्टॉल करें.

टाइप

AutofillBlockedType

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

ऑटोमैटिक भरने की सुविधा के डेटा की कैटगरी.

Enum

"contact_info"

"payments"

"identity_docs"

"travel"

"all"

IPHandlingPolicy

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

WebRTC के आईपी मैनेज करने की नीति.

Enum

"default"

"default_public_and_private_interfaces"

"default_public_interface_only"

"disable_non_proxied_udp"

प्रॉपर्टी

network

ये ऐसी सेटिंग होती हैं जो Chrome में नेटवर्क कनेक्शन को मैनेज करने के तरीके पर असर डालती हैं.

टाइप

ऑब्जेक्ट

प्रॉपर्टी

  • networkPredictionEnabled

    types.ChromeSetting<boolean>

    इस सुविधा के चालू होने पर Chrome, वेब ब्राउज़िंग के आपके अनुभव को बेहतर बनाने की कोशिश करता है. इसके लिए, वह डीएनएस एंट्री को पहले से हल कर देता है, सर्वर से टीसीपी और एसएसएल कनेक्शन पहले से खोल देता है, और पेजों को पहले से लोड कर देता है. इस सेटिंग को बंद करने पर, साइट के मालिकों के पास कॉन्टेंट को अनुमान के आधार पर लोड करने की सुविधा नहीं रहती. जैसे, Speculation Rules API के ज़रिए प्रीफ़ेचिंग या प्रीरेंडरिंग करना. इससे वेबपेज से शुरू होने वाले प्रीकनेक्ट या डीएनएस प्रीफ़ेच पर कोई असर नहीं पड़ता. इस प्राथमिकता की वैल्यू बूलियन होती है. डिफ़ॉल्ट रूप से, इसकी वैल्यू true होती है.

  • webRTCIPHandlingPolicy

    types.ChromeSetting<IPHandlingPolicy>

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

    उपयोगकर्ताओं को मीडिया की परफ़ॉर्मेंस/निजता से जुड़े फ़ैसले लेने की अनुमति दें. इससे यह तय होगा कि WebRTC ट्रैफ़िक को कैसे रूट किया जाएगा और स्थानीय पते की कितनी जानकारी शेयर की जाएगी. इस सेटिंग की वैल्यू, IPHandlingPolicy टाइप की होती है. इसकी डिफ़ॉल्ट वैल्यू default होती है.

services

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

टाइप

ऑब्जेक्ट

प्रॉपर्टी

  • alternateErrorPagesEnabled

    types.ChromeSetting<boolean>

    अगर यह सेटिंग चालू है, तो Chrome, नेविगेशन की गड़बड़ियों को ठीक करने के लिए किसी वेब सेवा का इस्तेमाल करता है. इस प्राथमिकता की वैल्यू बूलियन होती है. डिफ़ॉल्ट रूप से, इसकी वैल्यू true होती है.

  • autofillAddressEnabled

    types.ChromeSetting<boolean>

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

    यह सेटिंग चालू होने पर, Chrome पते और फ़ॉर्म में मौजूद अन्य डेटा को अपने-आप भरने का सुझाव देता है. इस प्राथमिकता की वैल्यू बूलियन होती है. डिफ़ॉल्ट रूप से, इसकी वैल्यू true होती है.

  • autofillCreditCardEnabled

    types.ChromeSetting<boolean>

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

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

  • autofillEnabled

    types.ChromeSetting<boolean>

    Chrome 70 से बंद कर दिया गया है

    कृपया privacy.services.autofillAddressEnabled और privacy.services.autofillCreditCardEnabled का इस्तेमाल करें. यह सुविधा, इस रिलीज़ में पिछले वर्शन के साथ काम करती है. हालांकि, आने वाले समय में इसे हटा दिया जाएगा.

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

  • passwordSavingEnabled

    types.ChromeSetting<boolean>

    इस सेटिंग को चालू करने पर, पासवर्ड मैनेजर आपसे पूछेगा कि क्या आपको पासवर्ड सेव करने हैं. इस प्राथमिकता की वैल्यू बूलियन होती है. डिफ़ॉल्ट रूप से, इसकी वैल्यू true होती है.

  • safeBrowsingEnabled

    types.ChromeSetting<boolean>

    इस सुविधा के चालू होने पर, Chrome आपको फ़िशिंग और मैलवेयर से बचाने की पूरी कोशिश करता है. इस प्राथमिकता की वैल्यू बूलियन होती है. डिफ़ॉल्ट रूप से, इसकी वैल्यू true होती है.

  • safeBrowsingExtendedReportingEnabled

    types.ChromeSetting<boolean>

    इस सेटिंग के चालू होने पर, Chrome उस पेज का कॉन्टेंट जैसी अतिरिक्त जानकारी Google को भेजेगा जिसे सुरक्षित ब्राउज़िंग की सुविधा ब्लॉक करती है. इस प्राथमिकता की वैल्यू बूलियन होती है. डिफ़ॉल्ट रूप से, इसकी वैल्यू false होती है.

  • searchSuggestEnabled

    types.ChromeSetting<boolean>

    इस सेटिंग के चालू होने पर, Chrome, ऑम्निबॉक्स में टाइप किए गए टेक्स्ट को आपके डिफ़ॉल्ट सर्च इंजन को भेजता है. इससे, वह सर्च इंजन आपको ऐसी वेबसाइटों और खोजों के बारे में अनुमानित जानकारी देता है जो आपके टाइप किए गए टेक्स्ट से मिलती-जुलती हैं. इस प्राथमिकता की वैल्यू बूलियन होती है. डिफ़ॉल्ट रूप से, इसकी वैल्यू true होती है.

  • spellingServiceEnabled

    types.ChromeSetting<boolean>

    इस सेटिंग के चालू होने पर, Chrome वर्तनी की गड़बड़ियों को ठीक करने के लिए, वेब सेवा का इस्तेमाल करता है. इस प्राथमिकता की वैल्यू बूलियन होती है. डिफ़ॉल्ट रूप से, इसकी वैल्यू false होती है.

  • translationServiceEnabled

    types.ChromeSetting<boolean>

    इस सेटिंग के चालू होने पर, Chrome उन पेजों का अनुवाद करने का विकल्प देता है जो आपकी भाषा में नहीं हैं. इस प्राथमिकता की वैल्यू बूलियन होती है. डिफ़ॉल्ट रूप से, इसकी वैल्यू true होती है.

websites

ये ऐसी सेटिंग होती हैं जिनसे यह तय होता है कि Chrome, वेबसाइटों के लिए कौनसी जानकारी उपलब्ध कराएगा.

टाइप

ऑब्जेक्ट

प्रॉपर्टी

  • adMeasurementEnabled

    types.ChromeSetting<boolean>

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

    अगर इसे बंद कर दिया जाता है, तो Attribution Reporting API और Private Aggregation API बंद हो जाते हैं. इस प्राथमिकता की वैल्यू बूलियन टाइप की होती है और डिफ़ॉल्ट वैल्यू true होती है. एक्सटेंशन, इन एपीआई को सिर्फ़ false पर सेट करके बंद कर सकते हैं. इन एपीआई को true पर सेट करने की कोशिश करने पर, गड़बड़ी का मैसेज दिखेगा.

  • doNotTrackEnabled

    types.ChromeSetting<boolean>

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

    इस सेटिंग के चालू होने पर, Chrome आपके अनुरोधों के साथ 'ट्रैक न करें' (DNT: 1) हेडर भेजता है. इस प्राथमिकता की वैल्यू बूलियन टाइप की होती है और डिफ़ॉल्ट वैल्यू false होती है.

  • fledgeEnabled

    types.ChromeSetting<boolean>

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

    अगर इसे बंद किया जाता है, तो Fledge API बंद हो जाता है. इस प्राथमिकता की वैल्यू बूलियन टाइप की होती है और डिफ़ॉल्ट वैल्यू true होती है. एक्सटेंशन सिर्फ़ इस एपीआई को बंद कर सकते हैं. इसके लिए, उन्हें वैल्यू को false पर सेट करना होगा. अगर इस एपीआई को true पर सेट करने की कोशिश की जाती है, तो गड़बड़ी का मैसेज दिखेगा.

  • hyperlinkAuditingEnabled

    types.ChromeSetting<boolean>

    इस सेटिंग के चालू होने पर, Chrome, ऑडिटिंग पिंग भेजता है. ऐसा तब होता है, जब कोई वेबसाइट (<a ping>) ऐसा करने का अनुरोध करती है. इस सेटिंग की वैल्यू, बूलियन टाइप की होती है. इसकी डिफ़ॉल्ट वैल्यू true होती है.

  • protectedContentEnabled

    types.ChromeSetting<boolean>

    सिर्फ़ Windows और ChromeOS पर उपलब्ध है: अगर यह कुकी चालू होती है, तो Chrome, प्लगिन को एक यूनीक आईडी देता है, ताकि सुरक्षित कॉन्टेंट चलाया जा सके. इस प्राथमिकता की वैल्यू बूलियन टाइप की होती है और डिफ़ॉल्ट वैल्यू true होती है.

  • referrersEnabled

    types.ChromeSetting<boolean>

    यह सुविधा चालू होने पर, Chrome आपके अनुरोधों के साथ referer हेडर भेजता है. हां, इस प्राथमिकता का नाम, गलत स्पेलिंग वाले हेडर से मेल नहीं खाता. नहीं, हम इसे नहीं बदलेंगे. इस प्राथमिकता की वैल्यू बूलियन टाइप की होती है और डिफ़ॉल्ट वैल्यू true होती है.

  • thirdPartyCookiesAllowed

    types.ChromeSetting<boolean>

    अगर यह सेटिंग बंद है, तो Chrome तीसरे पक्ष की साइटों को कुकी सेट करने से रोकता है. इस प्राथमिकता की वैल्यू बूलियन टाइप की होती है और डिफ़ॉल्ट वैल्यू true होती है. एक्सटेंशन, गुप्त मोड में इस एपीआई को चालू नहीं कर सकते. इस मोड में, तीसरे पक्ष की कुकी ब्लॉक होती हैं और इन्हें सिर्फ़ साइट लेवल पर अनुमति दी जा सकती है. अगर गुप्त मोड में इस एपीआई को 'सही है' पर सेट करने की कोशिश की जाती है, तो गड़बड़ी का मैसेज दिखेगा.

    ध्यान दें: अगर इस एपीआई से false मिलता है, तो भी कुछ साइटें तीसरे पक्ष की कुकी ऐक्सेस कर सकती हैं. ऐसा तब होता है, जब उनके पास छूट का मान्य अनुरोध हो या वे Storage Access API का इस्तेमाल करती हों.

  • topicsEnabled

    types.ChromeSetting<boolean>

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

    अगर इसे बंद किया जाता है, तो Topics API बंद हो जाता है. इस प्राथमिकता की वैल्यू बूलियन टाइप की होती है और डिफ़ॉल्ट वैल्यू true होती है. एक्सटेंशन सिर्फ़ इस एपीआई को बंद कर सकते हैं. इसके लिए, उन्हें वैल्यू को false पर सेट करना होगा. अगर इस एपीआई को true पर सेट करने की कोशिश की जाती है, तो गड़बड़ी का मैसेज दिखेगा.