chrome.events

ब्यौरा

chrome.events नेमस्पेस में कुछ ऐसे सामान्य टाइप होते हैं जिनका इस्तेमाल, कुछ दिलचस्प होने पर आपको सूचना देने के लिए, एपीआई इवेंट भेजने में इस्तेमाल किया जाता है.

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

Event एक ऑब्जेक्ट होता है, जो कुछ दिलचस्प होने पर आपको सूचना देता है. यह रही अलार्म बीत जाने पर सूचना पाने के लिए, chrome.alarms.onAlarm इवेंट को इस्तेमाल करने का उदाहरण:

chrome.alarms.onAlarm.addListener((alarm) => {
  appendToLog(`alarms.onAlarm -- name: ${alarm.name}, scheduledTime: ${alarm.scheduledTime}`);
});

जैसा कि उदाहरण में दिखाया गया है, addListener() का इस्तेमाल करके, सूचना पाने के लिए रजिस्टर किया जाता है. इसका तर्क addListener() हमेशा एक ऐसा फ़ंक्शन होता है जिसे आप इवेंट को मैनेज करने के लिए तय करते हैं, लेकिन फ़ंक्शन इस बात पर निर्भर करता है कि आप कौनसा इवेंट हैंडल कर रहे हैं. alarms.onAlarm के दस्तावेज़ देखे जा रहे हैं, देखें कि फ़ंक्शन में एक ही पैरामीटर है: alarms.Alarm ऑब्जेक्ट, जिसमें जानकारी है बीत चुके अलार्म के बारे में.

इवेंट का इस्तेमाल करने वाले एपीआई के उदाहरण: अलार्म, i18n, identity, रनटाइम. ज़्यादातर chrome एपीआई काम करते हैं.

एलान वाले इवेंट हैंडलर

डिक्लेरेटिव इवेंट हैंडलर, डिक्लेरेटिव कंडीशन वाले नियम तय करने में मदद करते हैं और कार्रवाइयां. शर्तों का मूल्यांकन ब्राउज़र में किया जाता है, न कि JavaScript इंजन में इंतज़ार का समय और बहुत ज़्यादा काम करने में मदद करता है.

डिक्लेरेटिव इवेंट हैंडलर का इस्तेमाल घोषणात्मक Content API. इस पेज पर सभी एलान वाले इवेंट के बुनियादी सिद्धांतों के बारे में बताया गया है हैंडलर.

नियम

सबसे आसान संभावित नियम में एक या उससे ज़्यादा शर्तें और एक या उससे ज़्यादा कार्रवाइयां होती हैं:

const rule = {
  conditions: [ /* my conditions */ ],
  actions: [ /* my actions */ ]
};

अगर कोई एक शर्त पूरी होती है, तो सभी कार्रवाइयां की जाती हैं.

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

const rule = {
  id: "my rule",  // optional, will be generated if not set.
  priority: 100,  // optional, defaults to 100.
  conditions: [ /* my conditions */ ],
  actions: [ /* my actions */ ]
};

इवेंट ऑब्जेक्ट

इवेंट ऑब्जेक्ट, नियमों के साथ काम कर सकते हैं. ये इवेंट ऑब्जेक्ट किसी कॉलबैक फ़ंक्शन को तब कॉल नहीं करते, जब इवेंट होते हैं, लेकिन यह जांच करते हैं कि रजिस्टर किए गए किसी नियम में कम से कम एक पूरी की गई शर्त है या नहीं. इसके बाद, उन्हें लागू करें इस नियम से जुड़ी कार्रवाइयां. डिक्लेरेटिव एपीआई के साथ काम करने वाले इवेंट ऑब्जेक्ट में तीन चीज़ें होती हैं काम के तरीके: events.Event.addRules(), events.Event.removeRules(), और events.Event.getRules().

नियम जोड़ना

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

const rule_list = [rule1, rule2, ...];
addRules(rule_list, (details) => {...});

अगर नियम सही तरीके से डाले गए हैं, तो details पैरामीटर में शामिल किए गए नियमों की एक श्रेणी मौजूद है पास किए गए rule_list की तरह ही दिख रहे हैं, जहां वैकल्पिक पैरामीटर id और priority, जनरेट की गई वैल्यू से भरे गए. अगर कोई नियम अमान्य है, उदाहरण के लिए, क्योंकि उसमें शामिल कोई अमान्य शर्त या कार्रवाई होने का मतलब है कि कोई भी नियम नहीं जोड़ा गया है. साथ ही, runtime.lastError वैरिएबल भी नहीं जोड़ा गया कॉलबैक फ़ंक्शन को कॉल किए जाने पर सेट होता है. rule_list के हर नियम में ऐसा आइडेंटिफ़ायर जिसका इस्तेमाल पहले से किसी अन्य नियम या किसी खाली आइडेंटिफ़ायर के लिए नहीं किया गया है.

ध्यान दें: नियम सभी ब्राउज़िंग सेशन में एक जैसे होते हैं. इसलिए, आपको के दौरान नियम इंस्टॉल करने चाहिए runtime.onInstalled इवेंट का इस्तेमाल करके, एक्सटेंशन इंस्टॉल होने का समय डालें. ध्यान दें कि यह इवेंट एक्सटेंशन के अपडेट होने पर भी ट्रिगर होता है. इसलिए, आपको पहले इंस्टॉल किए गए नए नियम रजिस्टर करने होंगे.

नियम हटाएं

नियमों को हटाने के लिए, removeRules() फ़ंक्शन को कॉल करें. यह नियम आइडेंटिफ़ायर का वैकल्पिक अरे स्वीकार करता है अपने पहले पैरामीटर के तौर पर और कॉलबैक फ़ंक्शन दूसरे पैरामीटर के तौर पर.

const rule_ids = ["id1", "id2", ...];
removeRules(rule_ids, () => {...});

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

नियम वापस पाएं

रजिस्टर किए गए नियमों की सूची फिर से पाने के लिए, getRules() फ़ंक्शन को कॉल करें. यह removeRules() और कॉलबैक फ़ंक्शन जैसे एक जैसे सिमैंटिक वाले नियम आइडेंटिफ़ायर की वैकल्पिक कैटगरी.

const rule_ids = ["id1", "id2", ...];
getRules(rule_ids, (details) => {...});

callback() फ़ंक्शन में पास किया गया details पैरामीटर, नियमों की कैटगरी के बारे में बताता है, जिसमें ये शामिल हैं वैकल्पिक पैरामीटर भरे गए.

परफ़ॉर्मेंस

बेहतर परफ़ॉर्मेंस पाने के लिए, इन दिशा-निर्देशों को ध्यान में रखें.

एक साथ कई नियमों को रजिस्टर करना और उनका रजिस्ट्रेशन रद्द करना. हर एक रजिस्ट्रेशन या रजिस्ट्रेशन रद्द करने के बाद, Chrome को ये काम करने होंगे इंटरनल डेटा स्ट्रक्चर को अपडेट करने के लिए. इस अपडेट को लागू करने में बहुत खर्चा करना होता है.

इसके बजाय

const rule1 = {...};
const rule2 = {...};
chrome.declarativeWebRequest.onRequest.addRules([rule1]);
chrome.declarativeWebRequest.onRequest.addRules([rule2]);

प्राथमिकता दें

const rule1 = {...};
const rule2 = {...};
chrome.declarativeWebRequest.onRequest.addRules([rule1, rule2]);

किसी events.UrlFilter में रेगुलर एक्सप्रेशन के बजाय सबस्ट्रिंग मैचिंग का इस्तेमाल करें. सबस्ट्रिंग पर आधारित मैचिंग बहुत तेज़ी से काम करती है.

इसके बजाय

const match = new chrome.declarativeWebRequest.RequestMatcher({
  url: {urlMatches: "example.com/[^?]*foo" }
});

प्राथमिकता दें

const match = new chrome.declarativeWebRequest.RequestMatcher({
  url: {hostSuffix: "example.com", pathContains: "foo"}
});

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

इसके बजाय

const condition1 = new chrome.declarativeWebRequest.RequestMatcher({
  url: { hostSuffix: 'example.com' }
});
const condition2 = new chrome.declarativeWebRequest.RequestMatcher({
  url: { hostSuffix: 'foobar.com' }
});
const rule1 = { conditions: [condition1],
                actions: [new chrome.declarativeWebRequest.CancelRequest()]
              };
const rule2 = { conditions: [condition2],
                actions: [new chrome.declarativeWebRequest.CancelRequest()]
              };
chrome.declarativeWebRequest.onRequest.addRules([rule1, rule2]);

प्राथमिकता दें

const condition1 = new chrome.declarativeWebRequest.RequestMatcher({
  url: { hostSuffix: 'example.com' }
});
const condition2 = new chrome.declarativeWebRequest.RequestMatcher({
  url: { hostSuffix: 'foobar.com' }
});
const rule = { conditions: [condition1, condition2],
              actions: [new chrome.declarativeWebRequest.CancelRequest()]
             };
chrome.declarativeWebRequest.onRequest.addRules([rule]);

फ़िल्टर किए गए इवेंट

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

फ़िल्टर किए गए इवेंट का मकसद, मैन्युअल तरीके से फ़िल्टर करने वाले कोड से ट्रांज़िशन की अनुमति देना है.

इसके बजाय

chrome.webNavigation.onCommitted.addListener((event) => {
  if (hasHostSuffix(event.url, 'google.com') ||
      hasHostSuffix(event.url, 'google.com.au')) {
    // ...
  }
});

प्राथमिकता दें

chrome.webNavigation.onCommitted.addListener((event) => {
  // ...
}, {url: [{hostSuffix: 'google.com'},
          {hostSuffix: 'google.com.au'}]});

इवेंट में ऐसे खास फ़िल्टर काम करते हैं जो उस इवेंट के लिए काम के हों. किसी इवेंट में शामिल फ़िल्टर की सूची उस इवेंट के लिए बने दस्तावेज़ के तहत, "फ़िल्टर" में सपोर्ट की सूची दिखती है सेक्शन में जाएं.

ऊपर दिए गए उदाहरण की तरह, यूआरएल का मिलान करते समय, इवेंट फ़िल्टर के लिए, एक जैसे यूआरएल को ही फ़िल्टर किया जा सकता है events.UrlFilter की मदद से बेहतरीन सुविधाएं दी जा सकती हैं. हालांकि, इनमें स्कीम और पोर्ट मैचिंग शामिल नहीं हैं.

टाइप

Event

एक ऐसा ऑब्जेक्ट जो Chrome इवेंट के लिए, लिसनर जोड़ने और उन्हें हटाने की अनुमति देता है.

प्रॉपर्टी

• ऐडलिसनर

  अमान्य

  किसी इवेंट के लिए, इवेंट लिसनर कॉलबैक को रजिस्टर करता है.

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

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

  • कॉलबैक

    H

    कोई इवेंट होने पर कॉल किया जाता है. इस फ़ंक्शन के पैरामीटर, इवेंट के टाइप के हिसाब से तय होते हैं.

• addRules

  अमान्य

  इवेंट मैनेज करने के लिए, नियमों को रजिस्टर करता है.

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

  (rules: Rule<anyany>[], callback?: function) => {...}

  • नियम

    नियम<anyany>[]

    रजिस्टर किए जाने वाले नियम. ये पहले से रजिस्टर किए गए नियमों की जगह नहीं ले सकते.

  • कॉलबैक

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

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

    (rules: Rule<anyany>[]) => void

    • नियम

      नियम<anyany>[]

      रजिस्टर किए गए नियम, वैकल्पिक पैरामीटर में वैल्यू होती हैं.

• getRules

  अमान्य

  फ़िलहाल, रजिस्टर किए गए मौजूदा नियमों की जानकारी दिखाता है.

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

  (ruleIdentifiers?: string[], callback: function) => {...}

  • ruleIdentifiers

    स्ट्रिंग[] ज़रूरी नहीं

    अगर कोई कलेक्शन पास किया जाता है, तो सिर्फ़ इस अरे में शामिल आइडेंटिफ़ायर वाले नियम ही दिखाए जाते हैं.

  • कॉलबैक

    फ़ंक्शन

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

    (rules: Rule<anyany>[]) => void

    • नियम

      नियम<anyany>[]

      रजिस्टर किए गए नियम, वैकल्पिक पैरामीटर में वैल्यू होती हैं.

• hasListener

  अमान्य

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

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

  • कॉलबैक

    H

    वह व्यक्ति जिसके रजिस्ट्रेशन स्टेटस की जांच की जाएगी.

  • returns

    बूलियन

    अगर इवेंट के लिए कॉलबैक रजिस्टर किया गया है, तो वैल्यू 'सही' होगी.

• hasListeners

  अमान्य

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

  () => {...}

  • returns

    बूलियन

    अगर इवेंट लिसनर इवेंट के लिए रजिस्टर हैं, तो वैल्यू 'सही' होगी.

• निकालेंलिसनर

  अमान्य

  किसी इवेंट से, इवेंट लिसनर के कॉलबैक का रजिस्ट्रेशन रद्द करता है.

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

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

  • कॉलबैक

    H

    वह लिसनर जिसका रजिस्ट्रेशन रद्द किया जाएगा.

• removeRules

  अमान्य

  रजिस्टर किए गए मौजूदा नियमों को रद्द करता है.

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

  (ruleIdentifiers?: string[], callback?: function) => {...}

  • ruleIdentifiers

    स्ट्रिंग[] ज़रूरी नहीं

    अगर कोई कलेक्शन पास किया जाता है, तो सिर्फ़ इस कलेक्शन में मौजूद आइडेंटिफ़ायर वाले नियमों का रजिस्ट्रेशन रद्द किया जाता है.

  • कॉलबैक

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

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

    () => void

Rule

इवेंट मैनेज करने के लिए, डिक्लेरेटिव नियम के बारे में जानकारी.

प्रॉपर्टी

• कार्रवाइयां

  कोई भी[]

  किसी एक शर्त के पूरा होने पर, ट्रिगर होने वाली कार्रवाइयों की सूची.

• शर्तें

  कोई भी[]

  कार्रवाइयों को ट्रिगर करने वाली शर्तों की सूची.

• आईडी

  स्ट्रिंग ज़रूरी नहीं

  ऐसा आइडेंटिफ़ायर जो इस नियम के बारे में बताने की अनुमति देता है.

• प्राथमिकता

  नंबर वैकल्पिक

  इस नियम की वैकल्पिक प्राथमिकता. डिफ़ॉल्ट तौर पर, यह 100 पर सेट होता है.

• टैग

  स्ट्रिंग[] ज़रूरी नहीं

  टैग का इस्तेमाल, नियमों की व्याख्या करने और नियमों के सेट पर कार्रवाइयां करने के लिए किया जा सकता है.

UrlFilter

अलग-अलग शर्तों के लिए यूआरएल को फ़िल्टर करता है. इवेंट फ़िल्टर करना देखें. सभी शर्तें, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होती हैं.

प्रॉपर्टी

• cidrBlocks

  स्ट्रिंग[] ज़रूरी नहीं

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

  अगर यूआरएल का होस्ट कोई आईपी पता है, तो यह मैच होता है. साथ ही, यह यूआरएल कलेक्शन में तय किए गए किसी भी सीआईडीआर ब्लॉक में शामिल होता है.

• hostContains

  स्ट्रिंग ज़रूरी नहीं

  अगर यूआरएल के होस्ट नाम में कोई खास स्ट्रिंग होती है, तो मिलान होता है. यह पता लगाने के लिए कि होस्ट नाम वाले कॉम्पोनेंट में प्रीफ़िक्स 'foo' है या नहीं, HostContains: '.foo' का इस्तेमाल करें. यह 'www.foobar.com' से मेल खाता है और 'foo.com' में शामिल है. इसकी वजह यह है कि होस्ट के नाम की शुरुआत में एक इंप्लिसिट डॉट जोड़ा जाता है. इसी तरह, HostContains का इस्तेमाल कॉम्पोनेंट सफ़िक्स ('foo.') से मैच करने और कॉम्पोनेंट ('.foo.') से पूरी तरह से मैच करने के लिए किया जा सकता है. आखिरी कॉम्पोनेंट के लिए सफ़िक्स और एग्ज़ैक्ट मैच, HostSuffix का इस्तेमाल करके अलग-अलग करने की ज़रूरत है. इसकी वजह यह है कि होस्ट के नाम के आखिर में कोई इंप्लिसिट डॉट नहीं जोड़ा जाता है.

• hostEquals

  स्ट्रिंग ज़रूरी नहीं

  यूआरएल का होस्ट नाम किसी तय स्ट्रिंग के बराबर होने पर मैच होता है.

• hostPrefix

  स्ट्रिंग ज़रूरी नहीं

  अगर यूआरएल का होस्ट नाम किसी तय स्ट्रिंग से शुरू होता है, तो मैच होता है.

• hostSuffix

  स्ट्रिंग ज़रूरी नहीं

  अगर यूआरएल का होस्ट नाम किसी तय स्ट्रिंग पर खत्म होता है, तो मैच होता है.

• originAndPathMatches

  स्ट्रिंग ज़रूरी नहीं

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

• pathContains

  स्ट्रिंग ज़रूरी नहीं

  अगर यूआरएल के पाथ सेगमेंट में कोई खास स्ट्रिंग होती है, तो मैच होता है.

• pathEquals

  स्ट्रिंग ज़रूरी नहीं

  अगर यूआरएल का पाथ सेगमेंट किसी तय स्ट्रिंग के बराबर होता है, तो मैच होता है.

• pathPrefix

  स्ट्रिंग ज़रूरी नहीं

  अगर यूआरएल का पाथ सेगमेंट किसी तय स्ट्रिंग से शुरू होता है, तो मैच होता है.

• pathSuffix

  स्ट्रिंग ज़रूरी नहीं

  अगर यूआरएल का पाथ सेगमेंट किसी तय स्ट्रिंग पर खत्म होता है, तो मैच होता है.

• ports

  (नंबर | number[])[] वैकल्पिक

  अगर यूआरएल का पोर्ट, किसी खास पोर्ट सूची में शामिल है, तो मिलान होता है. उदाहरण के लिए, [80, 443, [1000, 1200]] पोर्ट 80, 443 और 1000-1200 की रेंज में आने वाले सभी अनुरोधों से मेल खाता है.

• queryContains

  स्ट्रिंग ज़रूरी नहीं

  अगर यूआरएल के क्वेरी सेगमेंट में कोई खास स्ट्रिंग होती है, तो मैच होता है.

• queryEquals

  स्ट्रिंग ज़रूरी नहीं

  अगर यूआरएल का क्वेरी सेगमेंट किसी तय स्ट्रिंग के बराबर है, तो मैच होता है.

• queryPrefix

  स्ट्रिंग ज़रूरी नहीं

  अगर यूआरएल का क्वेरी सेगमेंट किसी तय स्ट्रिंग से शुरू होता है, तो मैच होता है.

• querySuffix

  स्ट्रिंग ज़रूरी नहीं

  अगर यूआरएल का क्वेरी सेगमेंट किसी तय स्ट्रिंग पर खत्म होता है, तो मैच होता है.

• स्कीम

  स्ट्रिंग[] ज़रूरी नहीं

  तब मैच होता है, जब यूआरएल की स्कीम, अरे में बताई गई किसी भी स्कीम के बराबर हो.

• urlContains

  स्ट्रिंग ज़रूरी नहीं

  अगर यूआरएल (बिना फ़्रैगमेंट आइडेंटिफ़ायर के) में कोई खास स्ट्रिंग हो, तो मैच होता है. अगर पोर्ट नंबर, डिफ़ॉल्ट पोर्ट नंबर से मेल खाते हैं, तो उन्हें यूआरएल से हटा दिया जाता है.

• urlEquals

  स्ट्रिंग ज़रूरी नहीं

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

• urlMatches

  स्ट्रिंग ज़रूरी नहीं

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

• urlPrefix

  स्ट्रिंग ज़रूरी नहीं

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

• urlSuffix

  स्ट्रिंग ज़रूरी नहीं

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