chrome.proxy

ब्यौरा

अनुमतियां

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

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

सिद्धांत और उनका इस्तेमाल

प्रॉक्सी सेटिंग, proxy.ProxyConfig ऑब्जेक्ट में तय की जाती हैं. Chrome की प्रॉक्सी सेटिंग के हिसाब से, सेटिंग में proxy.ProxyRules या proxy.PacScript हो सकता है.

प्रॉक्सी मोड

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

direct

direct मोड में, सभी कनेक्शन सीधे तौर पर बनाए जाते हैं. इनमें कोई प्रॉक्सी शामिल नहीं होता. इस मोड में, आपको ProxyConfig ऑब्जेक्ट में कोई और पैरामीटर नहीं है.

auto_detect

auto_detect मोड में, प्रॉक्सी कॉन्फ़िगरेशन को एक पीएसी स्क्रिप्ट से तय किया जाता है, जिसे डाउनलोड किया जा सकता है http://wpad/wpad.dat पर जाएं. यह मोड, ProxyConfig ऑब्जेक्ट में किसी और पैरामीटर की अनुमति नहीं देता है.

pac_script

pac_script मोड में, प्रॉक्सी कॉन्फ़िगरेशन को उस पीएसी स्क्रिप्ट से तय किया जाता है जिसे या तो वापस लाया गया है proxy.PacScript ऑब्जेक्ट में बताए गए यूआरएल से या data एलिमेंट से लिया गया यूआरएल proxy.PacScript ऑब्जेक्ट में बताया गया है. इसके अलावा, यह मोड किसी और पैरामीटर की अनुमति नहीं देता ProxyConfig ऑब्जेक्ट में.

fixed_servers

fixed_servers मोड में, प्रॉक्सी कॉन्फ़िगरेशन को proxy.ProxyRules ऑब्जेक्ट में कोड किया जाता है. यह स्ट्रक्चर के बारे में प्रॉक्सी नियमों में बताया गया है. इसके अलावा, fixed_servers मोड में आपको ProxyConfig ऑब्जेक्ट में पैरामीटर.

system

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

प्रॉक्सी नियम

proxy.ProxyRules ऑब्जेक्ट में singleProxy एट्रिब्यूट या इसका सबसेट हो सकता है proxyForHttp, proxyForHttps, proxyForFtp, और fallbackProxy.

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

प्रॉक्सी सर्वर ऑब्जेक्ट

प्रॉक्सी सर्वर को proxy.ProxyServer ऑब्जेक्ट में कॉन्फ़िगर किया गया है. प्रॉक्सी सर्वर से कनेक्शन (host एट्रिब्यूट से तय किया गया) scheme एट्रिब्यूट में बताए गए प्रोटोकॉल का इस्तेमाल करता है. अगर नहीं scheme तय किया गया है, प्रॉक्सी कनेक्शन डिफ़ॉल्ट रूप से http है.

अगर proxy.ProxyServer ऑब्जेक्ट में कोई port तय नहीं किया गया है, तो पोर्ट को स्कीम से लिया जाता है. ये डिफ़ॉल्ट पोर्ट होते हैं:

बायपास लिस्ट

अलग-अलग सर्वर को bypassList के साथ प्रॉक्सी से बाहर रखा जा सकता है. इस सूची में ये चीज़ें हो सकती हैं निम्नलिखित प्रविष्टियाँ:

[SCHEME://]HOST_PATTERN[:PORT]

HOST_PATTERN पैटर्न से मैच करने वाले सभी होस्टनेम को मैच करें. लीडिंग "." को "*.".

उदाहरण: "foobar.com", "*foobar.com", "*.foobar.com", "*foobar.com:99", "https://x.*.y.com:99".

पैटर्न	मैच करती स्ट्रिंग	मिलान नहीं होता है
".foobar.com"	"www.foobar.com"	"foobar.com"
"*.foobar.com"	"www.foobar.com"	"foobar.com"
"foobar.com"	"foobar.com"	"www.foobar.com"
"*foobar.com"	"foobar.com", "www.foobar.com", "foofoobar.com"

[SCHEME://]IP_LITERAL[:PORT]

वे यूआरएल मैच करें जो आईपी पते की लिटरल वैल्यू हैं. सैद्धांतिक तौर पर यह पहले मामले की तरह ही है, लेकिन का इस्तेमाल खास मामलों में किया जाता है. उदाहरण के लिए, "[0:0:0::1]" से मैचिंग "[::1]" पर मिलान करने के समान है क्योंकि आईपीवी6 के कैननिकल होने की प्रक्रिया अंदरूनी तौर पर की जाती है.

उदाहरण: 127.0.1, [0:0::1], [::1]:80, https://[::1]:443

IP_LITERAL/PREFIX_LENGTH_IN_BITS

ऐसे किसी भी यूआरएल का मिलान करें जिसमें दिए गए आईपी लिटरल (IP_LITERAL) में आईपी हो रेंज. IP श्रेणी (PREFIX_LENGTH_IN_BITS) को सीआईडीआर (सीआईडीआर) का इस्तेमाल करके तय किया गया है नोटेशन.

दी गई रेंज में मौजूद ऐसे किसी भी यूआरएल का मिलान करें जिसमें आईपी लिटरल हो. आईपी रेंज, सीआईडीआर का इस्तेमाल करके तय की गई है नोटेशन. उदाहरण: "192.168.1.1/16", "fefe:13::abc/33"

<local>

लिटरल स्ट्रिंग <local>, सामान्य होस्टनेम से मैच करती है. सामान्य होस्टनेम वह होता है जिसमें कोई डॉट हैं और यह एक IP लिटरल नहीं है. उदाहरण के लिए, example और localhost सामान्य होस्टनेम हैं, जबकि example.com, example., और [::1] नहीं हैं.

उदाहरण: "<local>"

उदाहरण

नीचे दिया गया कोड, foobar.com को छोड़कर सभी सर्वर पर एचटीटीपी कनेक्शन के लिए SOCKS 5 प्रॉक्सी सेट करता है और डायरेक्ट कनेक्शन. सेटिंग नियमित और गुप्त विंडो पर इस तरह लागू होती हैं गुप्त विंडो, नियमित विंडो से सेटिंग इनहेरिट करती हैं. Types API भी देखें दस्तावेज़.

var config = {
  mode: "fixed_servers",
  rules: {
    proxyForHttp: {
      scheme: "socks5",
      host: "1.2.3.4"
    },
    bypassList: ["foobar.com"]
  }
};
chrome.proxy.settings.set(
  {value: config, scope: 'regular'},
  function() {}
);

नीचे दिया गया कोड, कस्टम पीएसी स्क्रिप्ट सेट करता है.

var config = {
  mode: "pac_script",
  pacScript: {
    data: "function FindProxyForURL(url, host) {\n" +
          "  if (host == 'foobar.com')\n" +
          "    return 'PROXY blackhole:80';\n" +
          "  return 'DIRECT';\n" +
          "}"
  }
};
chrome.proxy.settings.set(
  {value: config, scope: 'regular'},
  function() {}
);

अगला स्निपेट, मौजूदा असरदार प्रॉक्सी सेटिंग के बारे में क्वेरी करता है. प्रभावी प्रॉक्सी सेटिंग ये हो सकती हैं या किसी नीति के ज़रिए तय किया जाता है. ज़्यादा जानकारी के लिए, Types API दस्तावेज़ देखें.

chrome.proxy.settings.get(
  {'incognito': false},
  function(config) {
    console.log(JSON.stringify(config));
  }
);

ध्यान दें कि set() को पास किया गया value ऑब्जेक्ट, यहां दिए गए value ऑब्जेक्ट के समान नहीं है get() का कॉलबैक फ़ंक्शन. बाद वाले एलिमेंट में rules.proxyForHttp.port एलिमेंट शामिल होगा.

chrome.proxy.onProxyError.addListener(
  callback: function,
)