chrome.declarativeNetRequest

refresh date: 2026-09-25 robots: noindex

বিবরণ

chrome.declarativeNetRequest API ব্যবহার করে ডিক্লারেটিভ নিয়ম উল্লেখ করার মাধ্যমে নেটওয়ার্ক রিকোয়েস্ট ব্লক বা পরিবর্তন করা হয়। এর ফলে এক্সটেনশন নেটওয়ার্ক অনুরোধ ইন্টারসেপ্ট না করে এবং তার কন্টেন্ট না দেখেই তা পরিবর্তন করতে পারে, যার ফলে আরও বেশি গোপনীয়তা প্রদান করা হয়।

অনুমতি

declarativeNetRequest
declarativeNetRequestWithHostAccess

declarativeNetRequestFeedback
host_permissions

উপলভ্যতা

Chrome 84+

ম্যানিফেস্ট

উপরে বর্ণিত অনুমতি ছাড়াও, নির্দিষ্ট ধরনের রুলসেট, বিশেষ করে স্ট্যাটিক রুলসেটের জন্য "declarative_net_request" ম্যানিফেস্ট কী ঘোষণা করতে হবে, যা "rule_resources" নামে একটি কী সহ ডিকশনারি হতে হবে। এই 'কী' হল একটি অ্যারে যাতে Ruleset ধরনের ডিকশনারি থাকে, যেমন নিচে দেখানো হয়েছে। (মনে রাখবেন যে 'Ruleset' নামটি ম্যানিফেস্টের JSON-এ দেখা যায় না কারণ এটি শুধুমাত্র একটি অ্যারে।) স্ট্যাটিক রুলসেট সম্পর্কে এই ডকুমেন্টে পরে ব্যাখ্যা করা হয়েছে।

{
  "name": "My extension",
  ...

  "declarative_net_request" : {
    "rule_resources" : [{
      "id": "ruleset_1",
      "enabled": true,
      "path": "rules_1.json"
    }, {
      "id": "ruleset_2",
      "enabled": false,
      "path": "rules_2.json"
    }]
  },
  "permissions": [
    "declarativeNetRequest",
    "declarativeNetRequestFeedback",
  ],
  "host_permissions": [
    "http://www.blogger.com/*",
    "http://*.google.com/*"
  ],
  ...
}

ধারণা ও ব্যবহার

এই API ব্যবহার করতে, এক বা একাধিক রুলসেট উল্লেখ করুন। একটি রুলসেটে নিয়মের অ্যারে থাকে। একটি নিয়ম নিম্নলিখিতগুলির মধ্যে যেকোনও একটি করে:

  • নেটওয়ার্ক সংক্রান্ত অনুরোধ ব্লক করুন।
  • স্কিমা আপগ্রেড করুন (http থেকে https)।
  • কোনও অনুরোধ ব্লক হওয়া আটকাতে, ব্লক করার জন্য ম্যাচ করা যেকোনও নিয়মকে নেগেট করুন।
  • নেটওয়ার্ক রিকোয়েস্ট রিডাইরেক্ট করুন।
  • অনুরোধ বা রেসপন্স হেডার পরিবর্তন করুন।

তিন ধরনের রুলসেট আছে, যেগুলি সামান্য আলাদা আলাদা উপায়ে ম্যানেজ করা হয়।

ডায়নামিক
ব্রাউজার সেশন এবং এক্সটেনশন আপগ্রেড জুড়ে থাকে এবং এক্সটেনশন ব্যবহার করার সময় জাভাস্ক্রিপ্ট ব্যবহার করে ম্যানেজ করা হয়।
সেশন
ব্রাউজার বন্ধ হয়ে গেলে এবং এক্সটেনশনের নতুন ভার্সন ইনস্টল করা হলে মুছে যায়। এক্সটেনশন ব্যবহার করার সময় জাভাস্ক্রিপ্ট ব্যবহার করে সেশন সংক্রান্ত নিয়ম ম্যানেজ করা হয়।
স্থির
কোনও এক্সটেনশন ইনস্টল বা আপগ্রেড করা হলে প্যাকেজ, ইনস্টল ও আপডেট করা হয়। স্ট্যাটিক নিয়ম JSON-ফর্ম্যাট করা নিয়ম ফাইলে স্টোর করা হয় এবং ম্যানিফেস্ট ফাইলে তালিকাভুক্ত করা হয়।

পরবর্তী কয়েকটি বিভাগে রুলসেটের ধরন সম্পর্কে বিস্তারিত ব্যাখ্যা করা হয়েছে।

ডায়নামিক ও সেশন-স্কোপড রুলসেট

এক্সটেনশন ব্যবহার করার সময় জাভাস্ক্রিপ্ট ব্যবহার করে ডায়নামিক ও সেশন রুলসেট ম্যানেজ করা হয়।

  • ব্রাউজার সেশন ও এক্সটেনশন আপগ্রেড জুড়ে ডায়নামিক নিয়ম বজায় থাকে।
  • ব্রাউজার বন্ধ হয়ে গেলে এবং এক্সটেনশনের নতুন ভার্সন ইনস্টল করা হলে সেশন সংক্রান্ত নিয়ম মুছে যায়।

এই ধরনের রুলসেট একটিই আছে। নিয়মের সীমা অতিক্রম না করলে, কোনও এক্সটেনশন updateDynamicRules() এবং updateSessionRules() কল করে ডায়নামিকভাবে নিয়ম যোগ করতে বা সরাতে পারে। নিয়মের সীমা সম্পর্কে তথ্যের জন্য, নিয়মের সীমা দেখুন। আপনি কোডের উদাহরণ-এর মধ্যে এর একটি উদাহরণ দেখতে পাবেন।

স্ট্যাটিক রুলসেট

ডায়নামিক ও সেশন নিয়মের মতো নয়, স্ট্যাটিক নিয়ম প্যাকেজ, ইনস্টল ও আপডেট করা হয় যখন কোনও এক্সটেনশন ইনস্টল বা আপগ্রেড করা হয়। এগুলি JSON ফর্ম্যাটে রুল ফাইলে সেভ করা থাকে, যা "declarative_net_request" এবং "rule_resources" কী উপরে যেমন বর্ণনা করা হয়েছে, সেইসাথে এক বা একাধিক Ruleset ডিকশনারি ব্যবহার করে এক্সটেনশনে নির্দেশ করা হয়। Ruleset ডিকশনারিতে নিয়ম ফাইলের পাথ, ফাইলে থাকা নিয়মসেটের আইডি এবং নিয়মসেট চালু নাকি বন্ধ আছে সেই তথ্য থাকে। আপনি প্রোগ্রাম্যাটিক্যালি কোনও রুলসেট চালু বা বন্ধ করলে, শেষ দুটি গুরুত্বপূর্ণ।

{
  ...
  "declarative_net_request" : {
    "rule_resources" : [{
      "id": "ruleset_1",
      "enabled": true,
      "path": "rules_1.json"
    },
    ...
    ]
  }
  ...
}

নিয়ম ফাইল পরীক্ষা করতে, আপনার এক্সটেনশন আনপ্যাক করে লোড করুন। ভুল স্ট্যাটিক নিয়ম সম্পর্কে সমস্যা ও সতর্কতা শুধুমাত্র আনপ্যাক করা এক্সটেনশনের জন্য দেখানো হয়। প্যাক করা এক্সটেনশনে ভুল স্ট্যাটিক নিয়ম এড়িয়ে যাওয়া হয়।

স্ট্যাটিক নিয়ম ও নিয়মাবলী চালু ও বন্ধ করা

রানটাইমে স্বতন্ত্র স্ট্যাটিক নিয়ম এবং সম্পূর্ণ স্ট্যাটিক নিয়ম সেট, দুটিই চালু বা বন্ধ করা হতে পারে।

চালু করা স্ট্যাটিক নিয়ম ও নিয়মসেটের সেট ব্রাউজার সেশন জুড়ে বজায় থাকে। এক্সটেনশন আপডেট জুড়ে কোনওটিই বজায় থাকে না, যার অর্থ হল আপডেট করার পরে শুধুমাত্র আপনার বেছে নেওয়া নিয়মগুলিই আপনার নিয়ম ফাইলে উপলভ্য থাকে।

পারফর্ম্যান্সের কারণে, একই সময়ে চালু করা যেতে পারে এমন নিয়ম ও নিয়মসেটের সংখ্যার উপরও সীমাবদ্ধতা রয়েছে। চালু থাকতে পারে এমন অতিরিক্ত নিয়মের সংখ্যা চেক করতে getAvailableStaticRuleCount() কল করুন। নিয়মের সীমা সম্পর্কে তথ্যের জন্য, নিয়মের সীমা দেখুন।

স্ট্যাটিক নিয়ম চালু বা বন্ধ করতে, updateStaticRules() কল করুন। এই পদ্ধতিতে একটি UpdateStaticRulesOptions অবজেক্ট নেওয়া হয়, যাতে চালু বা বন্ধ করার জন্য নিয়মের আইডি-র অ্যারে থাকে। Ruleset ডিকশনারির "id" কী ব্যবহার করে আইডিগুলি সংজ্ঞায়িত করা হয়।

স্ট্যাটিক রুলসেট চালু বা বন্ধ করতে, updateEnabledRulesets() কল করুন। এই পদ্ধতিতে একটি UpdateRulesetOptions অবজেক্ট নেওয়া হয়, যাতে চালু বা বন্ধ করার জন্য রুলসেটের আইডি-র অ্যারে থাকে। Ruleset ডিকশনারির "id" কী ব্যবহার করে আইডিগুলি সংজ্ঞায়িত করা হয়।

নিয়ম তৈরি করুন

ধরন যাই হোক না কেন, নিচে দেখানো চারটি ফিল্ড দিয়ে একটি নিয়ম শুরু হয়। "id" এবং "priority" কী-তে একটি সংখ্যা থাকলেও, "action" এবং "condition" কী-তে একাধিক ব্লক করা এবং রিডাইরেক্ট করার শর্ত থাকতে পারে। নিম্নলিখিত নিয়মটি "foo.com" থেকে শুরু হওয়া সমস্ত স্ক্রিপ্ট অনুরোধকে ব্লক করে, যার মধ্যে সাবস্ট্রিং হিসেবে "abc" সহ যেকোনও URL অন্তর্ভুক্ত।

{
  "id" : 1,
  "priority": 1,
  "action" : { "type" : "block" },
  "condition" : {
    "urlFilter" : "abc",
    "initiatorDomains" : ["foo.com"],
    "resourceTypes" : ["script"]
  }
}

urlFilter-এর সাথে মিলে যাওয়া অক্ষর

একটি নিয়মের "condition" কী, নির্দিষ্ট ডোমেনের অধীনে URL-এ কাজ করার জন্য "urlFilter" কী-কে অনুমতি দেয়। আপনি প্যাটার্ন ম্যাচিং টোকেন ব্যবহার করে প্যাটার্ন তৈরি করেন। নিচে কয়েকটি উদাহরণ দেখানো হল।

urlFilter ম্যাচ না মেলা URL
"abc" https://abcd.com
https://example.com/abcd		 https://ab.com
"abc*d" https://abcd.com
https://example.com/abcxyzd		 https://abc.com
"||a.example.com" https://a.example.com/
https://b.a.example.com/xyz		 https://example.com/
"|https*" https://example.com http://example.com/
http://https.com
"example*^123|" https://example.com/123
http://abc.com/example?123		 https://example.com/1234
https://abc.com/example0123

নিয়মের অগ্রাধিকার

ওয়েব পেজ থেকে পাঠানো অনুরোধের মাধ্যমে নিয়ম ট্রিগার করা হয়। কোনও নির্দিষ্ট অনুরোধের সাথে একাধিক নিয়ম মিলে গেলে, নিয়মগুলিকে অগ্রাধিকার দিতে হবে। এই বিভাগে ব্যাখ্যা করা হয়েছে যে কীভাবে সেগুলিকে অগ্রাধিকার দেওয়া হয়। অগ্রাধিকার দেওয়ার কাজটি দুটি ধাপে করা হয়।

  1. এক্সটেনশনের মধ্যে নিয়মের জন্য অগ্রাধিকার নির্ধারণ করা হয়।
  2. একাধিক এক্সটেনশন কোনও অনুরোধে নিয়ম প্রয়োগ করতে পারলে, নির্দিষ্ট অনুরোধের সাথে ম্যাচ করা সব এক্সটেনশনের জন্য অগ্রাধিকার নির্ধারণ করা হয়।

এইভাবে মেলানোর কথা ভাবা হচ্ছে: কোনও নির্দিষ্ট এক্সটেনশন যে নিয়মকে অগ্রাধিকার দেয়, সেটি অন্যান্য এক্সটেনশনের নিয়মের তুলনায় অগ্রাধিকার পাবে।

এক্সটেনশনের মধ্যে নিয়মের অগ্রাধিকার

একটি এক্সটেনশনের মধ্যে, নিম্নলিখিত প্রসেস ব্যবহার করে অগ্রাধিকার নির্ধারণ করা হয়:

  1. ডেভেলপারের দ্বারা নির্ধারিত সর্বোচ্চ অগ্রাধিকার (অন্যভাবে বলতে গেলে, "priority" ফিল্ড) সহ নিয়মটি রিটার্ন করা হয়।

  2. ডেভেলপারের সেট করা সর্বোচ্চ অগ্রাধিকার সহ একাধিক নিয়ম থাকলে, "action" ফিল্ড ব্যবহার করে নিম্নলিখিত ক্রমে নিয়মের অগ্রাধিকার সেট করা হয়:

    1. allow
    2. allowAllRequests
    3. block
    4. upgradeScheme
    5. redirect

  3. অ্যাকশনের ধরন block বা redirect না হলে, যেকোনও ম্যাচিং modifyHeaders নিয়ম মূল্যায়ন করা হয়। মনে রাখবেন, allow ও allowAllRequests-এর জন্য নির্দিষ্ট করা অগ্রাধিকারের চেয়ে কম অগ্রাধিকারের কোনও নিয়ম ডেভেলপার সেট করলে, সেই নিয়ম উপেক্ষা করা হয়।

  4. একাধিক নিয়ম একই হেডার পরিবর্তন করলে, ডেভেলপার-নির্ধারিত "priority" ফিল্ড এবং নির্দিষ্ট অপারেশন দ্বারা পরিবর্তন নির্ধারণ করা হয়।

    • কোনও নিয়ম যদি কোনও হেডারে যোগ করা হয়, তাহলে কম অগ্রাধিকারের নিয়মগুলি শুধুমাত্র সেই হেডারে যোগ করা যেতে পারে। সেট ও রিমুভ অপারেশন অনুমোদিত নয়।
    • কোনও নিয়ম যদি হেডার সেট করে, তাহলে কম অগ্রাধিকারের নিয়মগুলি শুধুমাত্র সেই হেডারে যোগ করা যেতে পারে। অন্য কোনও পরিবর্তন করার অনুমতি দেওয়া হয় না।
    • কোনও নিয়ম যদি হেডার সরিয়ে দেয়, তাহলে কম অগ্রাধিকারের নিয়মগুলি হেডারকে আর পরিবর্তন করতে পারবে না।

এক্সটেনশনের মধ্যে নিয়মের অগ্রাধিকার

কোনও অনুরোধের সাথে শুধুমাত্র একটি এক্সটেনশনের নিয়ম মিললে, সেই নিয়ম প্রয়োগ করা হয়। তবে, একাধিক এক্সটেনশন কোনও অনুরোধের সাথে ম্যাচ করলে, নিম্নলিখিত প্রসেস ব্যবহার করা হয়:

  1. "action" ফিল্ড ব্যবহার করে নিম্নলিখিত ক্রমে নিয়মগুলিকে অগ্রাধিকার দেওয়া হয়:

    1. block
    2. redirect বা upgradeScheme
    3. allow বা allowAllRequests

  2. একাধিক নিয়ম ম্যাচ করলে, সবচেয়ে সম্প্রতি ইনস্টল করা এক্সটেনশন অগ্রাধিকার পায়।

নিয়মের সীমা

ব্রাউজারে নিয়ম লোড ও মূল্যায়ন করার জন্য পারফর্ম্যান্স ওভারহেড আছে, তাই API ব্যবহার করার সময় কিছু সীমাবদ্ধতা প্রযোজ্য হয়। আপনি যে ধরনের নিয়ম ব্যবহার করছেন তার উপর সীমা নির্ভর করে।

স্ট্যাটিক নিয়ম

ম্যানিফেস্ট ফাইলে ঘোষণা করা নিয়ম ফাইলে উল্লেখ করা নিয়মগুলিই হল স্ট্যাটিক নিয়ম। একটি এক্সটেনশন "rule_resources" ম্যানিফেস্ট কী-এর অংশ হিসেবে সর্বাধিক ৫০টি স্ট্যাটিক রুলসেট নির্দিষ্ট করতে পারে, তবে এই রুলসেটগুলির মধ্যে একবারে মাত্র ১০টি চালু করা যেতে পারে। পরেরটিকে MAX_NUMBER_OF_ENABLED_STATIC_RULESETS বলা হয়। সামগ্রিকভাবে, সেইসব রুলসেটে কমপক্ষে ৩০,০০০ নিয়ম আছে। এটিকে GUARANTEED_MINIMUM_STATIC_RULES বলা হয়।

তারপরে কতগুলি নিয়ম উপলভ্য থাকবে তা নির্ভর করে ব্যবহারকারীর ব্রাউজারে ইনস্টল করা সমস্ত এক্সটেনশন দ্বারা কতগুলি নিয়ম চালু করা হয়েছে তার উপর। আপনি রানটাইমে getAvailableStaticRuleCount()-এ কল করে এই নম্বরটি খুঁজে পেতে পারেন। আপনি কোডের উদাহরণ-এর মধ্যে এর একটি উদাহরণ দেখতে পাবেন।

ডায়নামিক ও সেশন সংক্রান্ত নিয়ম

ডায়নামিক ও সেশন নিয়মের ক্ষেত্রে প্রযোজ্য সীমা স্ট্যাটিক নিয়মের চেয়ে সহজ। দুটির মোট সংখ্যা ৫০০০-এর বেশি হতে পারবে না। এটিকে MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES বলা হয়।

regex ব্যবহার করে এমন নিয়ম

সব ধরনের নিয়ম রেগুলার এক্সপ্রেশন ব্যবহার করতে পারে; তবে, প্রতিটি ধরনের মোট রেগুলার এক্সপ্রেশন নিয়মের সংখ্যা ১০০০-এর বেশি হতে পারবে না। একে MAX_NUMBER_OF_REGEX_RULES বলা হয়।

এছাড়াও, প্রতিটি নিয়ম কম্পাইল করার পরে ২ কেবির কম হতে হবে। এটি মোটামুটিভাবে নিয়মের জটিলতার সাথে সম্পর্কিত। আপনি যদি এই সীমা অতিক্রম করে এমন কোনও নিয়ম লোড করার চেষ্টা করেন, তাহলে আপনি নিচের মতো একটি সতর্কতা দেখতে পাবেন এবং নিয়মটি উপেক্ষা করা হবে।

rules_1.json: Rule with id 1 specified a more complex regex than allowed
as part of the "regexFilter" key.

সার্ভিস ওয়ার্কারের সাথে ইন্টার‍্যাকশন

একটি declarativeNetRequest শুধুমাত্র নেটওয়ার্ক স্ট্যাকে পৌঁছানো অনুরোধের ক্ষেত্রে প্রযোজ্য। এর মধ্যে HTTP ক্যাশে থেকে পাওয়া উত্তর অন্তর্ভুক্ত, তবে সার্ভিস ওয়ার্কারের onfetch হ্যান্ডলারের মাধ্যমে পাওয়া উত্তর অন্তর্ভুক্ত নাও হতে পারে। declarativeNetRequest, সার্ভিস ওয়ার্কারের মাধ্যমে জেনারেট করা বা CacheStorage থেকে পাওয়া উত্তরকে প্রভাবিত করবে না, তবে সার্ভিস ওয়ার্কারের মাধ্যমে fetch()-এ করা কলকে প্রভাবিত করবে।

ওয়েবে অ্যাক্সেসযোগ্য রিসোর্স

একটি declarativeNetRequest নিয়ম কোনও সর্বজনীন রিসোর্স অনুরোধ থেকে এমন কোনও রিসোর্সে রিডাইরেক্ট করতে পারে না যা ওয়েবে অ্যাক্সেসযোগ্য নয়। এটি করলে সমস্যা দেখা দেয়। এমনকি নির্দিষ্ট করা ওয়েব অ্যাক্সেসযোগ্য রিসোর্স রিডাইরেক্ট করা এক্সটেনশনের মালিকানাধীন হলেও এটি প্রযোজ্য। declarativeNetRequest-এর জন্য রিসোর্স ঘোষণা করতে, ম্যানিফেস্টের "web_accessible_resources" অ্যারে ব্যবহার করুন।

উদাহরণ

কোডের উদাহরণ

ডায়নামিক নিয়ম আপডেট করুন

updateDynamicRules()-কে কীভাবে কল করতে হয় তা নিম্নলিখিত উদাহরণ থেকে দেখুন। updateSessionRules()-এর জন্য পদ্ধতি একই।

// Get arrays containing new and old rules
const newRules = await getNewRules();
const oldRules = await chrome.declarativeNetRequest.getDynamicRules();
const oldRuleIds = oldRules.map(rule => rule.id);

// Use the arrays to update the dynamic rules
await chrome.declarativeNetRequest.updateDynamicRules({
  removeRuleIds: oldRuleIds,
  addRules: newRules
});

স্ট্যাটিক রুলসেট আপডেট করুন

উপলভ্য স্ট্যাটিক রুলসেটের সংখ্যা এবং চালু করা স্ট্যাটিক রুলসেটের সর্বাধিক সংখ্যা বিবেচনা করে কীভাবে রুলসেট চালু এবং বন্ধ করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে। আপনার প্রয়োজনীয় স্ট্যাটিক নিয়মের সংখ্যা অনুমোদিত সংখ্যার চেয়ে বেশি হলে আপনি এটি করবেন। এটি কাজ করার জন্য, আপনার কিছু রুলসেট বন্ধ করে (ম্যানিফেস্ট ফাইলের মধ্যে "Enabled"-কে false-এ সেট করে) কিছু রুলসেট ইনস্টল করতে হবে।

async function updateStaticRules(enableRulesetIds, disableCandidateIds) {
  // Create the options structure for the call to updateEnabledRulesets()
  let options = { enableRulesetIds: enableRulesetIds }
  // Get the number of enabled static rules
  const enabledStaticCount = await chrome.declarativeNetRequest.getEnabledRulesets();
  // Compare rule counts to determine if anything needs to be disabled so that
  // new rules can be enabled
  const proposedCount = enableRulesetIds.length;
  if (enabledStaticCount + proposedCount > chrome.declarativeNetRequest.MAX_NUMBER_OF_ENABLED_STATIC_RULESETS) {
    options.disableRulesetIds = disableCandidateIds
  }
  // Update the enabled static rules
  await chrome.declarativeNetRequest.updateEnabledRulesets(options);
}

নিয়মের উদাহরণ

Chrome কীভাবে এক্সটেনশনে নিয়মকে অগ্রাধিকার দেয় তা নিচের উদাহরণ থেকে বোঝা যায়। সেগুলি পর্যালোচনা করার সময়, আপনি একটি পৃথক উইন্ডোতে অগ্রাধিকার নিয়মগুলি খুলতে চাইতে পারেন।

"অগ্রাধিকার" কী

এইসব উদাহরণের ক্ষেত্রে *://*.example.com/*-এর জন্য হোস্টের অনুমতি প্রয়োজন।

কোনও নির্দিষ্ট URL-এর অগ্রাধিকার নির্ধারণ করতে, (ডেভেলপার-নির্ধারিত) "priority" কী, "action" কী এবং "urlFilter" কী দেখুন। এইসব উদাহরণ নিচে দেখানো উদাহরণ রুল ফাইলকে রেফার করে।

https://google.com-এ নেভিগেশন
দুটি নিয়ম এই URL-এর ক্ষেত্রে প্রযোজ্য: ১ ও ৪ আইডি সহ নিয়ম। আইডি ১ সহ নিয়মটি প্রযোজ্য হয় কারণ "block" অ্যাকশনের অগ্রাধিকার "redirect" অ্যাকশনের চেয়ে বেশি। বাকি নিয়মগুলি প্রযোজ্য নয় কারণ সেগুলি আরও বড় URL-এর জন্য।
https://google.com/1234-এ নেভিগেট করা
URL-এর দৈর্ঘ্য বেশি হওয়ার কারণে, আইডি ২-এর নিয়ম এখন আইডি ১ ও ৪-এর নিয়মের সাথেও ম্যাচ করে। আইডি ২ সহ নিয়মটি প্রযোজ্য কারণ "allow"-এর অগ্রাধিকার "block" এবং "redirect"-এর থেকে বেশি।
https://google.com/12345-এ নেভিগেশন
এই URL-এর সাথে চারটি নিয়মই ম্যাচ করে। আইডি 3 সহ নিয়মটি প্রযোজ্য কারণ এর ডেভেলপার-নির্ধারিত অগ্রাধিকার গ্রুপের মধ্যে সর্বোচ্চ।
[
  {
    "id": 1,
    "priority": 1,
    "action": { "type": "block" },
    "condition": {"urlFilter": "google.com", "resourceTypes": ["main_frame"] }
  },
  {
    "id": 2,
    "priority": 1,
    "action": { "type": "allow" },
    "condition": { "urlFilter": "google.com/123", "resourceTypes": ["main_frame"] }
  },
  {
    "id": 3,
    "priority": 2,
    "action": { "type": "block" },
    "condition": { "urlFilter": "google.com/12345", "resourceTypes": ["main_frame"] }
  },
  {
    "id": 4,
    "priority": 1,
    "action": { "type": "redirect", "redirect": { "url": "https://example.com" } },
    "condition": { "urlFilter": "google.com", "resourceTypes": ["main_frame"] }
  },
]

রিডাইরেক্ট

নিচের উদাহরণে *://*.example.com/*-এর জন্য হোস্টের অনুমতি প্রয়োজন।

নিম্নলিখিত উদাহরণে দেখানো হয়েছে যে কীভাবে example.com থেকে এক্সটেনশনের মধ্যে থাকা কোনও পৃষ্ঠায় অনুরোধ রিডাইরেক্ট করা যায়। এক্সটেনশন পাথ /a.jpg-এর সমাধান হল chrome-extension://EXTENSION_ID/a.jpg, যেখানে EXTENSION_ID হল আপনার এক্সটেনশনের আইডি। এটি কাজ করার জন্য, ম্যানিফেস্টে /a.jpg-কে ওয়েব অ্যাক্সেসিবল রিসোর্স হিসেবে ঘোষণা করতে হবে।

{
  "id": 1,
  "priority": 1,
  "action": { "type": "redirect", "redirect": { "extensionPath": "/a.jpg" } },
  "condition": {
    "urlFilter": "https://www.example.com",
    "resourceTypes": ["main_frame"]
  }
}

নিম্নলিখিত উদাহরণে, example.com-এর সাবডোমেনে রিডাইরেক্ট করতে "transform" কী ব্যবহার করা হয়েছে। example.com থেকে যেকোনও স্কিম সহ অনুরোধ ইন্টারসেপ্ট করতে এটি ডোমেন নেম অ্যাঙ্কর ("||") ব্যবহার করে। "transform"-এ "scheme" কী নির্দিষ্ট করে যে সাবডোমেনে রিডাইরেক্ট করার সময় সবসময় "https" ব্যবহার করা হবে।

{
  "id": 1,
  "priority": 1,
  "action": {
    "type": "redirect",
    "redirect": {
      "transform": { "scheme": "https", "host": "new.example.com" }
    }
  },
  "condition": {
    "urlFilter": "||example.com",
    "resourceTypes": ["main_frame"]
  }
}

নিম্নলিখিত উদাহরণে https://www.abc.xyz.com/path থেকে https://abc.xyz.com/path-এ রিডাইরেক্ট করতে রেগুলার এক্সপ্রেশন ব্যবহার করা হয়েছে। "regexFilter" কীতে, লক্ষ্য করুন কীভাবে পিরিয়ড এড়িয়ে যাওয়া হয়েছে এবং ক্যাপচারিং গ্রুপ "abc" বা "def" বেছে নিয়েছে। "regexSubstitution" কী "\1" ব্যবহার করে রেগুলার এক্সপ্রেশনের প্রথম রিটার্ন করা ম্যাচ নির্দিষ্ট করে। এই ক্ষেত্রে, রিডাইরেক্ট করা URL থেকে "abc" ক্যাপচার করা হয় এবং সাবস্টিটিউশনে প্লেস করা হয়।

{
  "id": 1,
  "priority": 1,
  "action": {
    "type": "redirect",
    "redirect": {
      "regexSubstitution": "https://\\1.xyz.com/"
    }
  },
  "condition": {
    "regexFilter": "^https://www\\.(abc|def)\\.xyz\\.com/",
    "resourceTypes": [
      "main_frame"
    ]
  }
}

হেডার

নিম্নলিখিত উদাহরণটি মূল ফ্রেম এবং যেকোনও সাব ফ্রেম থেকে সব কুকি সরিয়ে দেয়।

{
  "id": 1,
  "priority": 1,
  "action": {
    "type": "modifyHeaders",
    "requestHeaders": [{ "header": "cookie", "operation": "remove" }]
  },
  "condition": { "resourceTypes": ["main_frame", "sub_frame"] }
}

ধরন

DomainType

এটি বর্ণনা করে যে অনুরোধটি যে ফ্রেম থেকে এসেছে সেটি ফার্স্ট-পার্টি নাকি থার্ড-পার্টি। কোনও অনুরোধকে ফার্স্ট-পার্টি বলা হয় যদি এটির ডোমেন (eTLD+1) সেই ফ্রেমের ডোমেনের সাথে মিলে যায় যেখান থেকে অনুরোধটি করা হয়েছে।

Enum

"firstParty"
নেটওয়ার্ক অনুরোধটি যে ফ্রেম থেকে শুরু হয়েছে তার ফার্স্ট পার্টি।

"thirdParty"
নেটওয়ার্ক অনুরোধটি যে ফ্রেম থেকে শুরু হয়েছে তার থার্ড-পার্টি।

ExtensionActionOptions

Chrome 88+

প্রপার্টি

  • displayActionCountAsBadgeText

    বুলিয়ান ঐচ্ছিক

    এক্সটেনশনের ব্যাজ টেক্সট হিসেবে কোনও পৃষ্ঠার জন্য অ্যাকশন কাউন্ট অটোমেটিক দেখানো হবে কিনা। এই পছন্দ সেশন জুড়ে বজায় থাকে।

  • tabUpdate

    TabActionCountUpdate ঐচ্ছিক

    Chrome 89+

    ট্যাবের অ্যাকশন কাউন্ট কীভাবে অ্যাডজাস্ট করা উচিত তার বিবরণ।

GetDisabledRuleIdsOptions

Chrome 111+

প্রপার্টি

  • rulesetId

    স্ট্রিং

    স্ট্যাটিক Ruleset-এর সাথে সংশ্লিষ্ট আইডি।

GetRulesFilter

Chrome 111+

প্রপার্টি

  • ruleIds

    number[] ঐচ্ছিক

    উল্লেখ করা থাকলে, শুধুমাত্র ম্যাচিং আইডি সহ নিয়ম অন্তর্ভুক্ত করা হয়।

HeaderInfo

Chrome 128+

প্রপার্টি

  • excludedValues

    string[] ঐচ্ছিক

    উল্লেখ করা থাকলে, হেডার থাকলেও এই শর্ত মিলবে না, তবে এর ভ্যালুতে এই তালিকার অন্তত একটি এলিমেন্ট থাকবে। এটি values-এর মতো একই ম্যাচ প্যাটার্ন সিনট্যাক্স ব্যবহার করে।

  • হেডার

    স্ট্রিং

    হেডারের নাম। values এবং excludedValues, দুটির কোনওটিই উল্লেখ করা না থাকলে, এই শর্তটি শুধুমাত্র নামের সাথে ম্যাচ করে।

  • মান

    string[] ঐচ্ছিক

    উল্লেখ করা থাকলে, হেডারের ভ্যালু এই তালিকার অন্তত একটি প্যাটার্নের সাথে মিললে এই শর্তটি মিলে যায়। এটি কেস-ইনসেনসিটিভ হেডার ভ্যালু ম্যাচিং এবং নিম্নলিখিত কনস্ট্রাক্টকে সাপোর্ট করে:

    '*' : যেকোনও সংখ্যক অক্ষরের সাথে মেলে।

    '?' : শূন্য বা একটি অক্ষরের সাথে মেলে।

    '*' এবং '?' ব্যাকস্ল্যাশ দিয়ে এড়ানো যেতে পারে, যেমন '\*' এবং '\?'

HeaderOperation

Chrome 86+

এটি "modifyHeaders" নিয়মের জন্য সম্ভাব্য অপারেশন বর্ণনা করে।

Enum

"append"
নির্দিষ্ট হেডারের জন্য নতুন এন্ট্রি যোগ করে। অনুরোধের হেডার পরিবর্তন করার সময়, এই অপারেশনটি শুধুমাত্র নির্দিষ্ট হেডারের জন্য কাজ করে।

"set"
নির্দিষ্ট হেডারের জন্য নতুন ভ্যালু সেট করে, একই নামের যেকোনও বিদ্যমান হেডার সরিয়ে দেয়।

"remove"
নির্দিষ্ট হেডারের জন্য সব এন্ট্রি সরিয়ে দেয়।

IsRegexSupportedResult

Chrome 87+

প্রপার্টি

  • isSupported

    বুলিয়ান

  • কারণ

    UnsupportedRegexReason ঐচ্ছিক

    রেগুলার এক্সপ্রেশন কেন কাজ করে না তার কারণ উল্লেখ করে। isSupported ফলস হলে তবেই প্রদান করা হয়।

MatchedRule

প্রপার্টি

  • ruleId

    নম্বর

    ম্যাচিং নিয়মের আইডি।

  • rulesetId

    স্ট্রিং

    এই নিয়মটি যে Ruleset-এর অন্তর্গত, তার আইডি। ডায়নামিক নিয়মের সেট থেকে তৈরি হওয়া নিয়মের ক্ষেত্রে, এটি DYNAMIC_RULESET_ID-এর সমান হবে।

MatchedRuleInfo

প্রপার্টি

  • নিয়ম

    MatchedRule

  • tabId

    নম্বর

    ট্যাবটি এখনও অ্যাক্টিভ থাকলে, যে ট্যাব থেকে অনুরোধটি এসেছে সেটির tabId। অন্যথায় -১।

  • timeStamp

    নম্বর

    যে সময়ে নিয়মটি মিলেছে। টাইমস্ট্যাম্প সময়ের জন্য Javascript কনভেনশন অনুযায়ী হবে, অর্থাৎ যুগ থেকে মিলিসেকেন্ডের সংখ্যা।

MatchedRuleInfoDebug

প্রপার্টি

  • অনুরোধ

    RequestDetails

    যে অনুরোধের জন্য নিয়মটি মিলেছে তার বিবরণ।

  • নিয়ম

    MatchedRule

MatchedRulesFilter

প্রপার্টি

  • minTimeStamp

    নম্বর ঐচ্ছিক

    উল্লেখ করা থাকলে, শুধুমাত্র প্রদত্ত টাইমস্ট্যাম্পের পরে নিয়ম মেলে।

  • tabId

    নম্বর ঐচ্ছিক

    উল্লেখ করা থাকলে, শুধুমাত্র প্রদত্ত ট্যাবের জন্য নিয়ম মেলে। -১-এ সেট করা থাকলে, কোনও অ্যাক্টিভ ট্যাবের সাথে যুক্ত নয় এমন নিয়মের সাথে ম্যাচ করে।

ModifyHeaderInfo

Chrome 86+

প্রপার্টি

  • হেডার

    স্ট্রিং

    যে হেডারের নাম পরিবর্তন করতে হবে।

  • অপারেশন

    HeaderOperation

    হেডারে যে অপারেশনটি করা হবে।

  • মান

    স্ট্রিং ঐচ্ছিক

    হেডারের জন্য নতুন ভ্যালু। append এবং set অপারেশনের জন্য অবশ্যই নির্দিষ্ট করতে হবে।

QueryKeyValue

প্রপার্টি

  • কী

    স্ট্রিং

  • replaceOnly

    বুলিয়ান ঐচ্ছিক

    Chrome 94+

    সত্য হলে, কোয়েরি কী আগে থেকেই থাকলে তবেই সেটি পরিবর্তন করা হয়। অন্যথায়, 'কী' না থাকলে সেটিও যোগ করা হয়। ডিফল্ট হিসেবে false সেট করা থাকে।

  • মান

    স্ট্রিং

QueryTransform

প্রপার্টি

  • addOrReplaceParams

    QueryKeyValue[] ঐচ্ছিক

    কোয়েরি কী-ভ্যালু পেয়ারের তালিকা যোগ বা পরিবর্তন করতে হবে।

  • removeParams

    string[] ঐচ্ছিক

    কোয়েরি কী-এর তালিকা সরিয়ে দিতে হবে।

Redirect

প্রপার্টি

  • extensionPath

    স্ট্রিং ঐচ্ছিক

    এক্সটেনশন ডিরেক্টরির সাথে সম্পর্কিত পাথ। '/' দিয়ে শুরু হতে হবে।

  • regexSubstitution

    স্ট্রিং ঐচ্ছিক

    regexFilter নির্দিষ্ট করে এমন নিয়মের জন্য সাবস্টিটিউশন প্যাটার্ন। URL-এর মধ্যে regexFilter-এর প্রথম ম্যাচ এই প্যাটার্ন দিয়ে পরিবর্তন করা হবে। regexSubstitution-এর মধ্যে, ব্যাকস্ল্যাশ-এস্কেপ করা সংখ্যা (\১ থেকে \৯) ব্যবহার করে সংশ্লিষ্ট ক্যাপচার গ্রুপ যোগ করা যেতে পারে। \0 সম্পূর্ণ ম্যাচিং টেক্সটকে বোঝায়।

  • রূপান্তর করুন

    URLTransform ঐচ্ছিক

    URL ট্রান্সফর্মেশন পারফর্ম করতে হবে।

  • URL

    স্ট্রিং ঐচ্ছিক

    রিডাইরেক্ট URL। জাভাস্ক্রিপ্ট URL-এ রিডাইরেক্ট করার অনুমতি নেই।

RegexOptions

Chrome 87+

প্রপার্টি

  • isCaseSensitive

    বুলিয়ান ঐচ্ছিক

    regex-এ ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয় কিনা। ডিফল্ট হল সত্য।

  • regex

    স্ট্রিং

    চেক করার জন্য রেগুলার এক্সপ্রেশন।

  • requireCapturing

    বুলিয়ান ঐচ্ছিক

    নির্দিষ্ট করা regex ক্যাপচার করতে হবে কিনা। শুধুমাত্র রিডাইরেক্ট নিয়মের জন্য ক্যাপচার করা প্রয়োজন যা regexSubstition অ্যাকশন নির্দিষ্ট করে। ডিফল্ট হল false।

RequestDetails

প্রপার্টি

  • documentId

    স্ট্রিং ঐচ্ছিক

    Chrome 106+

    এই অনুরোধটি ফ্রেমের জন্য হলে, ফ্রেমের ডকুমেন্টের অনন্য শনাক্তকারী।

  • documentLifecycle

    DocumentLifecycle ঐচ্ছিক

    Chrome 106+

    ফ্রেমের ডকুমেন্টের লাইফসাইকেল, যদি এই অনুরোধ কোনও ফ্রেমের জন্য হয়।

  • frameId

    নম্বর

    0 ভ্যালু থেকে বোঝা যায় যে অনুরোধটি মূল ফ্রেমে করা হয়েছে; পজিটিভ ভ্যালু থেকে বোঝা যায় যে অনুরোধটি সাবফ্রেমের আইডিতে করা হয়েছে। (সাব-)ফ্রেমের ডকুমেন্ট লোড করা হলে (type হল main_frame বা sub_frame), frameId এই ফ্রেমের আইডি দেখায়, বাইরের ফ্রেমের আইডি নয়। ফ্রেম আইডি একটি ট্যাবের মধ্যে অনন্য।

  • frameType

    FrameType ঐচ্ছিক

    Chrome 106+

    এই অনুরোধটি ফ্রেমের জন্য হলে, ফ্রেমের ধরন।

  • ইনিশিয়েটর

    স্ট্রিং ঐচ্ছিক

    যেখান থেকে অনুরোধটি শুরু করা হয়েছিল। রিডাইরেক্টের মাধ্যমে এটি পরিবর্তন হয় না। এটি যদি একটি অস্বচ্ছ উৎস হয়, তাহলে 'null' স্ট্রিং ব্যবহার করা হবে।

  • মেথড

    স্ট্রিং

    স্ট্যান্ডার্ড HTTP পদ্ধতি।

  • parentDocumentId

    স্ট্রিং ঐচ্ছিক

    Chrome 106+

    ফ্রেমের পেরেন্ট ডকুমেন্টের অনন্য শনাক্তকারী, যদি এই অনুরোধটি কোনও ফ্রেমের জন্য হয় এবং তার কোনও পেরেন্ট থাকে।

  • parentFrameId

    নম্বর

    অনুরোধ পাঠানো ফ্রেমকে যে ফ্রেম র‍্যাপ করে সেটির আইডি। কোনও পেরেন্ট ফ্রেম না থাকলে -১ হিসেবে সেট করুন।

  • requestId

    স্ট্রিং

    অনুরোধের আইডি। অনুরোধ আইডি ব্রাউজার সেশনে অনন্য।

  • tabId

    নম্বর

    যে ট্যাবে অনুরোধ করা হয়েছে সেটির আইডি। অনুরোধটি কোনও ট্যাবের সাথে সম্পর্কিত না হলে -১-এ সেট করুন।

  • ধরন

    ResourceType

    অনুরোধের রিসোর্সের ধরন।

  • URL

    স্ট্রিং

    অনুরোধের URL।

RequestMethod

Chrome 91+

এটি নেটওয়ার্ক অনুরোধের HTTP অনুরোধ পদ্ধতি বর্ণনা করে।

Enum

"কানেক্ট"

"মুছুন"

"get"

"head"

"বিকল্প"

"প্যাচ"

"পোস্ট"

"put"

"অন্যান্য"

ResourceType

এটি নেটওয়ার্ক অনুরোধের রিসোর্সের ধরন বর্ণনা করে।

Enum

"main_frame"

"sub_frame"

"স্টাইলশিট"

"স্ক্রিপ্ট"

"ছবি"

"font"

"অবজেক্ট"

"xmlhttprequest"

"পিং"

"csp_report"

"মিডিয়া"

"websocket"

"webtransport"

"webbundle"

"অন্যান্য"

Rule

প্রপার্টি

  • অ্যাকশন

    RuleAction

    এই নিয়ম ম্যাচ করলে যে অ্যাকশন নেওয়া হবে।

  • শর্ত

    RuleCondition

    যে শর্তের অধীনে এই নিয়ম ট্রিগার করা হয়।

  • id

    নম্বর

    একটি আইডি যা অনন্যভাবে একটি নিয়ম শনাক্ত করে। বাধ্যতামূলক এবং >= ১ হতে হবে।

  • অগ্রাধিকার

    নম্বর ঐচ্ছিক

    নিয়মের অগ্রাধিকার। ডিফল্ট হিসেবে ১ সেট করা থাকে। নির্দিষ্ট করা থাকলে, >= ১ হতে হবে।

RuleAction

প্রপার্টি

  • রিডাইরেক্ট

    রিডাইরেক্ট ঐচ্ছিক

    কীভাবে রিডাইরেক্ট করা হবে তা বর্ণনা করে। শুধুমাত্র রিডাইরেক্ট নিয়মের ক্ষেত্রে প্রযোজ্য।

  • requestHeaders

    ModifyHeaderInfo[] ঐচ্ছিক

    Chrome 86+

    অনুরোধের জন্য পরিবর্তন করতে হবে এমন অনুরোধের হেডার। RuleActionType "modifyHeaders" হলে তবেই এটি সঠিক বলে গণ্য হবে।

  • responseHeaders

    ModifyHeaderInfo[] ঐচ্ছিক

    Chrome 86+

    অনুরোধের জন্য পরিবর্তন করার রেসপন্স হেডার। RuleActionType "modifyHeaders" হলে তবেই এটি সঠিক বলে গণ্য হবে।

  • ধরন

    RuleActionType

    যে ধরনের অ্যাকশন পারফর্ম করতে হবে।

RuleActionType

প্রদত্ত RuleCondition ম্যাচ করলে কী ধরনের অ্যাকশন নিতে হবে তা বর্ণনা করে।

Enum

"ব্লক"
নেটওয়ার্ক অনুরোধ ব্লক করুন।

"redirect"
নেটওয়ার্ক অনুরোধ রিডাইরেক্ট করুন।

"অনুমতি দিন"
নেটওয়ার্ক রিকোয়েস্টে অনুমতি দিন। অনুরোধের সাথে মিলে যায় এমন কোনও অনুমোদনের নিয়ম থাকলে, অনুরোধটি ইন্টারসেপ্ট করা হবে না।

"upgradeScheme"
নেটওয়ার্ক অনুরোধের url-এর স্কিম http বা ftp হলে, সেটিকে https-এ আপগ্রেড করুন।

"modifyHeaders"
নেটওয়ার্ক অনুরোধ থেকে অনুরোধ/প্রতিক্রিয়া হেডার পরিবর্তন করুন।

"allowAllRequests"
ফ্রেম অনুরোধ সহ ফ্রেম হায়ারার্কির মধ্যে সব অনুরোধের অনুমতি দিন।

RuleCondition

প্রপার্টি

  • domainType

    DomainType ঐচ্ছিক

    নেটওয়ার্ক অনুরোধটি যে ডোমেন থেকে এসেছে তার ফার্স্ট-পার্টি নাকি থার্ড-পার্টি তা উল্লেখ করে। বাদ দেওয়া হলে, সব অনুরোধ গ্রহণ করা হয়।

  • ডোমেন

    string[] ঐচ্ছিক

    Chrome 101 থেকে বন্ধ করা হয়েছে

    পরিবর্তে initiatorDomains ব্যবহার করুন

    নিয়মটি শুধুমাত্র domains-এর তালিকা থেকে আসা নেটওয়ার্ক অনুরোধের সাথে মিলবে।

  • excludedDomains

    string[] ঐচ্ছিক

    Chrome 101 থেকে বন্ধ করা হয়েছে

    পরিবর্তে excludedInitiatorDomains ব্যবহার করুন

    excludedDomains-এর তালিকা থেকে শুরু হওয়া নেটওয়ার্ক অনুরোধের সাথে নিয়মটি মিলবে না।

  • excludedInitiatorDomains

    string[] ঐচ্ছিক

    Chrome 101+

    excludedInitiatorDomains-এর তালিকা থেকে শুরু হওয়া নেটওয়ার্ক অনুরোধের সাথে নিয়মটি মিলবে না। তালিকাটি খালি থাকলে বা বাদ দেওয়া হলে, কোনও ডোমেন বাদ দেওয়া হয় না। এটি initiatorDomains-এর চেয়ে বেশি অগ্রাধিকার পায়।

    মনে রাখবেন:

    • "a.example.com"-এর মতো সাব-ডোমেনও অনুমোদিত।
    • এন্ট্রিতে শুধুমাত্র ascii অক্ষর থাকতে হবে।
    • আন্তর্জাতিক ডোমেনের জন্য পিউনিকোড এনকোডিং ব্যবহার করুন।
    • এটি অনুরোধের URL-এর সাথে নয়, অনুরোধকারীর সাথে ম্যাচ করে।
    • তালিকাভুক্ত ডোমেনের সাব-ডোমেনও বাদ দেওয়া হয়েছে।
  • excludedRequestDomains

    string[] ঐচ্ছিক

    Chrome 101+

    ডোমেন excludedRequestDomains-এর তালিকা থেকে কোনও একটির সাথে মিলে গেলে, নিয়মটি নেটওয়ার্ক অনুরোধের সাথে মিলবে না। তালিকাটি খালি থাকলে বা বাদ দেওয়া হলে, কোনও ডোমেন বাদ দেওয়া হয় না। এটি requestDomains-এর চেয়ে বেশি অগ্রাধিকার পায়।

    মনে রাখবেন:

    • "a.example.com"-এর মতো সাব-ডোমেনও অনুমোদিত।
    • এন্ট্রিতে শুধুমাত্র ascii অক্ষর থাকতে হবে।
    • আন্তর্জাতিক ডোমেনের জন্য পিউনিকোড এনকোডিং ব্যবহার করুন।
    • তালিকাভুক্ত ডোমেনের সাব-ডোমেনও বাদ দেওয়া হয়েছে।
  • excludedRequestMethods

    RequestMethod[] ঐচ্ছিক

    Chrome 91+

    নিয়মের সাথে মিলবে না এমন অনুরোধ পদ্ধতির তালিকা। requestMethods এবং excludedRequestMethods-এর মধ্যে যেকোনও একটি উল্লেখ করতে হবে। এর মধ্যে কোনওটিই নির্দিষ্ট করা না থাকলে, সব অনুরোধের পদ্ধতি ম্যাচ করা হয়।

  • excludedResourceTypes

    ResourceType[] ঐচ্ছিক

    রিসোর্সের ধরনের তালিকা যার সাথে নিয়মটি মিলবে না। resourceTypes এবং excludedResourceTypes-এর মধ্যে যেকোনও একটি উল্লেখ করতে হবে। এর মধ্যে কোনওটিই উল্লেখ করা না থাকলে, "main_frame" ছাড়া সব ধরনের রিসোর্স ব্লক করা হয়।

  • excludedResponseHeaders

    HeaderInfo[] ঐচ্ছিক

    Chrome 128+

    অনুরোধটি এই তালিকার কোনও রেসপন্স হেডার শর্তের সাথে মিললে (যদি নির্দিষ্ট করা থাকে) নিয়মটি মেলে না। excludedResponseHeaders এবং responseHeaders, দুটিই উল্লেখ করা থাকলে, excludedResponseHeaders প্রপার্টিকে অগ্রাধিকার দেওয়া হয়।

  • excludedTabIds

    number[] ঐচ্ছিক

    Chrome 92+

    tabs.Tab.id-এর তালিকা যার সাথে নিয়মটি ম্যাচ করা উচিত নয়। tabs.TAB_ID_NONE-এর আইডি সেইসব অনুরোধ বাদ দেয় যেগুলি কোনও ট্যাব থেকে শুরু হয় না। শুধুমাত্র সেশন-স্কোপড নিয়মের জন্য কাজ করে।

  • excludedTopDomains

    string[] ঐচ্ছিক

    Chrome 145+

    সংশ্লিষ্ট টপ-লেভেল ফ্রেমের ডোমেন excludedTopDomains-এর তালিকার কোনও একটির সাথে মিলে গেলে, নিয়মটি নেটওয়ার্ক অনুরোধের সাথে মিলবে না। তালিকাটি খালি থাকলে বা বাদ দেওয়া হলে, কোনও ডোমেন বাদ দেওয়া হয় না। এটি topDomains-এর চেয়ে বেশি অগ্রাধিকার পায়।

    মনে রাখবেন:

    • "a.example.com"-এর মতো সাব-ডোমেনও অনুমোদিত।
    • এন্ট্রিতে শুধুমাত্র ascii অক্ষর থাকতে হবে।
    • আন্তর্জাতিক ডোমেনের জন্য পিউনিকোড এনকোডিং ব্যবহার করুন।
    • তালিকাভুক্ত ডোমেনের সাব-ডোমেনও বাদ দেওয়া হয়েছে।
    • কোনও সম্পর্কিত টপ-লেভেল ফ্রেম ছাড়া অনুরোধের ক্ষেত্রে (যেমন, ServiceWorker-এর মাধ্যমে শুরু করা অনুরোধ), পরিবর্তে অনুরোধ শুরুকারীর ডোমেন বিবেচনা করা হয়।
  • initiatorDomains

    string[] ঐচ্ছিক

    Chrome 101+

    নিয়মটি শুধুমাত্র initiatorDomains-এর তালিকা থেকে আসা নেটওয়ার্ক অনুরোধের সাথে মিলবে। তালিকা বাদ দেওয়া হলে, সব ডোমেন থেকে আসা অনুরোধের ক্ষেত্রে নিয়মটি প্রযোজ্য হয়। খালি তালিকা অনুমোদিত নয়।

    মনে রাখবেন:

    • "a.example.com"-এর মতো সাব-ডোমেনও অনুমোদিত।
    • এন্ট্রিতে শুধুমাত্র ascii অক্ষর থাকতে হবে।
    • আন্তর্জাতিক ডোমেনের জন্য পিউনিকোড এনকোডিং ব্যবহার করুন।
    • এটি অনুরোধের URL-এর সাথে নয়, অনুরোধকারীর সাথে ম্যাচ করে।
    • তালিকাভুক্ত ডোমেনের সাব-ডোমেনও ম্যাচ করা হয়।
  • isUrlFilterCaseSensitive

    বুলিয়ান ঐচ্ছিক

    urlFilter বা regexFilter (যেটি উল্লেখ করা হয়েছে) ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করে কিনা। ডিফল্ট হল মিথ্যা।

  • regexFilter

    স্ট্রিং ঐচ্ছিক

    নেটওয়ার্ক অনুরোধের url-এর সাথে ম্যাচ করার জন্য রেগুলার এক্সপ্রেশন। এটি RE2 সিনট্যাক্স অনুসরণ করে।

    মনে রাখবেন: urlFilter বা regexFilter-এর মধ্যে যেকোনও একটি উল্লেখ করা যেতে পারে।

    মনে রাখবেন: regexFilter-এ শুধুমাত্র ASCII অক্ষর থাকতে হবে। এটি এমন একটি URL-এর সাথে ম্যাচ করা হয় যেখানে হোস্টকে পিউনিকোড ফর্ম্যাটে এনকোড করা হয় (আন্তর্জাতিক ডোমেনের ক্ষেত্রে) এবং অন্য যেকোনও নন-ascii অক্ষরকে utf-8-এ URL এনকোড করা হয়।

  • requestDomains

    string[] ঐচ্ছিক

    Chrome 101+

    ডোমেনটি requestDomains-এর তালিকার সাথে মিললে তবেই নিয়মটি নেটওয়ার্ক অনুরোধের সাথে মিলবে। তালিকা বাদ দেওয়া হলে, সব ডোমেন থেকে আসা অনুরোধের ক্ষেত্রে নিয়মটি প্রযোজ্য হয়। খালি তালিকা অনুমোদিত নয়।

    মনে রাখবেন:

    • "a.example.com"-এর মতো সাব-ডোমেনও অনুমোদিত।
    • এন্ট্রিতে শুধুমাত্র ascii অক্ষর থাকতে হবে।
    • আন্তর্জাতিক ডোমেনের জন্য পিউনিকোড এনকোডিং ব্যবহার করুন।
    • তালিকাভুক্ত ডোমেনের সাব-ডোমেনও ম্যাচ করা হয়।
  • requestMethods

    RequestMethod[] ঐচ্ছিক

    Chrome 91+

    HTTP অনুরোধ পদ্ধতির তালিকা যা নিয়মের সাথে মিলতে পারে। খালি তালিকা অনুমোদিত নয়।

    মনে রাখবেন: requestMethods নিয়মের শর্ত উল্লেখ করলে, HTTP(s) নয় এমন অনুরোধও বাদ দেওয়া হবে, তবে excludedRequestMethods উল্লেখ করলে তা হবে না।

  • resourceTypes

    ResourceType[] ঐচ্ছিক

    রুল ম্যাচ করতে পারে এমন রিসোর্সের ধরনের তালিকা। খালি তালিকা অনুমোদিত নয়।

    মনে রাখবেন: এটি অবশ্যই allowAllRequests নিয়মের জন্য নির্দিষ্ট করতে হবে এবং এতে শুধুমাত্র sub_frame এবং main_frame রিসোর্সের ধরন অন্তর্ভুক্ত থাকতে পারে।

  • responseHeaders

    HeaderInfo[] ঐচ্ছিক

    Chrome 128+

    অনুরোধটি এই তালিকার (যদি নির্দিষ্ট করা থাকে) কোনও রেসপন্স হেডার শর্তের সাথে মিললে নিয়মটি মিলে যায়।

  • tabIds

    number[] ঐচ্ছিক

    Chrome 92+

    tabs.Tab.id-এর তালিকা যার সাথে নিয়মটি মিলতে হবে। tabs.TAB_ID_NONE-এর আইডি সেইসব অনুরোধের সাথে মিলে যায় যেগুলি কোনও ট্যাব থেকে শুরু হয় না। খালি তালিকা অনুমোদিত নয়। শুধুমাত্র সেশন-স্কোপড নিয়মের জন্য কাজ করে।

  • topDomains

    string[] ঐচ্ছিক

    Chrome 145+

    নিয়মটি শুধুমাত্র তখনই নেটওয়ার্ক অনুরোধের সাথে মিলবে যখন সংশ্লিষ্ট টপ-লেভেল ফ্রেমের ডোমেন topDomains-এর তালিকার কোনও একটির সাথে মিলবে। তালিকা বাদ দেওয়া হলে, সব টপ-লেভেল ফ্রেম ডোমেনের সাথে যুক্ত অনুরোধের ক্ষেত্রে নিয়মটি প্রযোজ্য হয়। খালি তালিকা অনুমোদিত নয়।

    মনে রাখবেন:

    • "a.example.com"-এর মতো সাব-ডোমেনও অনুমোদিত।
    • এন্ট্রিতে শুধুমাত্র ascii অক্ষর থাকতে হবে।
    • আন্তর্জাতিক ডোমেনের জন্য পিউনিকোড এনকোডিং ব্যবহার করুন।
    • তালিকাভুক্ত ডোমেনের সাব-ডোমেনও ম্যাচ করা হয়।
    • কোনও সম্পর্কিত টপ-লেভেল ফ্রেম ছাড়া অনুরোধের ক্ষেত্রে (যেমন, ServiceWorker-এর মাধ্যমে শুরু করা অনুরোধ), পরিবর্তে অনুরোধ শুরুকারীর ডোমেন বিবেচনা করা হয়।
  • urlFilter

    স্ট্রিং ঐচ্ছিক

    নেটওয়ার্ক অনুরোধের URL-এর সাথে যে প্যাটার্ন ম্যাচ করে। কাজ করে এমন কনস্ট্রাক্ট:

    '*' : ওয়াইল্ডকার্ড: যেকোনও সংখ্যক অক্ষরের সাথে ম্যাচ করে।

    '|' : বাঁদিকের/ডানদিকের অ্যাঙ্কর: প্যাটার্নের যেকোনও প্রান্তে ব্যবহার করা হলে, যথাক্রমে URL-এর শুরু/শেষ নির্দিষ্ট করে।

    '||' : ডোমেন নেম অ্যাঙ্কর: প্যাটার্নের শুরুতে ব্যবহার করা হলে, URL-এর (সাব-)ডোমেনের শুরু নির্দিষ্ট করে।

    '^' : বিভাজক অক্ষর: এটি অক্ষর, সংখ্যা বা নিম্নলিখিতগুলির মধ্যে যেকোনও একটি ছাড়া অন্য যেকোনও কিছুর সাথে মেলে: _, -, . বা %। এটি URL-এর শেষের সাথেও ম্যাচ করে।

    তাই urlFilter নিম্নলিখিত অংশগুলি নিয়ে গঠিত: (ঐচ্ছিক বাঁদিকের/ডোমেন নামের অ্যাঙ্কর) + প্যাটার্ন + (ঐচ্ছিক ডানদিকের অ্যাঙ্কর)।

    বাদ দেওয়া হলে, সব URL ম্যাচ করা হয়। খালি স্ট্রিং অনুমোদিত নয়।

    ||* দিয়ে শুরু হওয়া প্যাটার্ন অনুমোদিত নয়। এর পরিবর্তে * ব্যবহার করুন।

    মনে রাখবেন: urlFilter বা regexFilter-এর মধ্যে যেকোনও একটি উল্লেখ করা যেতে পারে।

    মনে রাখবেন: urlFilter-এ শুধুমাত্র ASCII অক্ষর থাকতে হবে। এটি এমন একটি URL-এর সাথে ম্যাচ করা হয় যেখানে হোস্টকে পিউনিকোড ফর্ম্যাটে এনকোড করা হয় (আন্তর্জাতিক ডোমেনের ক্ষেত্রে) এবং অন্য যেকোনও নন-ascii অক্ষরকে utf-8-এ URL এনকোড করা হয়। যেমন, অনুরোধের URL http://abc.рф?q=ф হলে, urlFilter http://abc.xn--p1ai/?q=%D1%84 URL-এর সাথে ম্যাচ করা হবে।

RuleConditionKeys

Chrome 145+

Enum

"urlFilter"

"regexFilter"

"isUrlFilterCaseSensitive"

"initiatorDomains"

"excludedInitiatorDomains"

"requestDomains"

"excludedRequestDomains"

"topDomains"

"excludedTopDomains"

"ডোমেন"

"excludedDomains"

"resourceTypes"

"excludedResourceTypes"

"requestMethods"

"excludedRequestMethods"

"domainType"

"tabIds"

"excludedTabIds"

"responseHeaders"

"excludedResponseHeaders"

Ruleset

প্রপার্টি

  • সক্ষমিত

    বুলিয়ান

    নিয়মাবলী ডিফল্ট হিসেবে চালু করা আছে কিনা।

  • id

    স্ট্রিং

    একটি নন-এম্পটি স্ট্রিং যা অনন্যভাবে রুলসেট শনাক্ত করে। '_' দিয়ে শুরু হওয়া আইডি ইন্টার্নাল ব্যবহারের জন্য রিজার্ভ করা থাকে।

  • পথ

    স্ট্রিং

    এক্সটেনশন ডিরেক্টরির সাথে সম্পর্কিত JSON রুলসেটের পাথ।

RulesMatchedDetails

প্রপার্টি

  • rulesMatchedInfo

    MatchedRuleInfo[]

    প্রদত্ত ফিল্টারের সাথে ম্যাচ করা নিয়ম।

TabActionCountUpdate

Chrome 89+

প্রপার্টি

  • বৃদ্ধি হয়েছে

    নম্বর

    ট্যাবের অ্যাকশন কাউন্ট কতটা বাড়াতে হবে। নেগেটিভ মান থাকলে গণনা কমবে।

  • tabId

    নম্বর

    যে ট্যাবের জন্য অ্যাকশন কাউন্ট আপডেট করতে হবে।

TestMatchOutcomeResult

Chrome 103+

প্রপার্টি

  • matchedRules

    MatchedRule[]

    কাল্পনিক অনুরোধের সাথে মিলে যায় এমন নিয়ম (যদি থাকে)।

TestMatchRequestDetails

Chrome 103+

প্রপার্টি

  • ইনিশিয়েটর

    স্ট্রিং ঐচ্ছিক

    হাইপোথেটিক্যাল অনুরোধের জন্য ইনিশিয়েটর URL (যদি থাকে)।

  • মেথড

    RequestMethod ঐচ্ছিক

    কাল্পনিক অনুরোধের স্ট্যান্ডার্ড HTTP পদ্ধতি। HTTP অনুরোধের জন্য ডিফল্ট হিসেবে "get" সেট করা থাকে এবং HTTP নয় এমন অনুরোধের জন্য উপেক্ষা করা হয়।

  • responseHeaders

    অবজেক্ট ঐচ্ছিক

    Chrome 129+

    অনুরোধটি পাঠানোর আগে ব্লক বা রিডাইরেক্ট করা না হলে, কাল্পনিক উত্তর দ্বারা প্রদান করা হেডার। একটি অবজেক্ট হিসেবে দেখানো হয় যা স্ট্রিং ভ্যালুর একটি তালিকার সাথে একটি হেডার নাম ম্যাপ করে। উল্লেখ করা না থাকলে, কাল্পনিক রেসপন্স খালি রেসপন্স হেডার ফিরিয়ে দেবে, যা হেডারের অনুপস্থিতির সাথে মেলে এমন নিয়মের সাথে মিলতে পারে। যেমন, {"content-type": ["text/html; charset=utf-8", "multipart/form-data"]}

  • tabId

    নম্বর ঐচ্ছিক

    যে ট্যাবে হাইপোথেটিক্যাল অনুরোধ করা হয় সেটির আইডি। আসল ট্যাব আইডির সাথে মিলতে হবে না। ডিফল্ট হল -১, যার অর্থ হল অনুরোধটি কোনও ট্যাবের সাথে সম্পর্কিত নয়।

  • topUrl

    স্ট্রিং ঐচ্ছিক

    Chrome 145+

    অনুরোধের জন্য সংশ্লিষ্ট টপ-লেভেল ফ্রেম URL (যদি থাকে)।

  • ধরন

    ResourceType

    কাল্পনিক অনুরোধের রিসোর্স টাইপ।

  • URL

    স্ট্রিং

    কাল্পনিক অনুরোধের URL।

UnsupportedRegexReason

Chrome 87+

প্রদত্ত রেগুলার এক্সপ্রেশন কেন কাজ করে না তার কারণ বর্ণনা করে।

Enum

"syntaxError"
রেগুলার এক্সপ্রেশনের সিনট্যাক্স ভুল অথবা এতে এমন ফিচার ব্যবহার করা হয়েছে যা RE2 সিনট্যাক্সে উপলভ্য নয়।

"memoryLimitExceeded"
রেগুলার এক্সপ্রেশন মেমরির সীমা ছাড়িয়ে গেছে।

UpdateRuleOptions

Chrome 87+

প্রপার্টি

  • addRules

    নিয়ম[] ঐচ্ছিক

    যোগ করার নিয়ম।

  • removeRuleIds

    number[] ঐচ্ছিক

    যেসব নিয়ম সরাতে হবে সেগুলির আইডি। যেকোনও ভুল আইডি এড়িয়ে যাওয়া হবে।

UpdateRulesetOptions

Chrome 87+

প্রপার্টি

  • disableRulesetIds

    string[] ঐচ্ছিক

    স্ট্যাটিক Ruleset-এর সাথে সম্পর্কিত আইডি সেট যা বন্ধ করা উচিত।

  • enableRulesetIds

    string[] ঐচ্ছিক

    স্ট্যাটিক Ruleset-এর সাথে সম্পর্কিত আইডির সেট যা চালু করা উচিত।

UpdateStaticRulesOptions

Chrome 111+

প্রপার্টি

  • disableRuleIds

    number[] ঐচ্ছিক

    বন্ধ করার জন্য Ruleset-এ নিয়মের সাথে সম্পর্কিত আইডির সেট।

  • enableRuleIds

    number[] ঐচ্ছিক

    চালু করার জন্য Ruleset-এ নিয়মের সাথে সম্পর্কিত আইডির সেট।

  • rulesetId

    স্ট্রিং

    স্ট্যাটিক Ruleset-এর সাথে সংশ্লিষ্ট আইডি।

URLTransform

প্রপার্টি

  • ফ্র্যাগমেন্ট

    স্ট্রিং ঐচ্ছিক

    অনুরোধের জন্য নতুন ফ্র্যাগমেন্ট। এটি খালি হতে হবে, সেক্ষেত্রে আগে থেকে থাকা ফ্র্যাগমেন্ট মুছে যাবে; অথবা '#' দিয়ে শুরু হতে হবে।

  • হোস্ট

    স্ট্রিং ঐচ্ছিক

    অনুরোধের জন্য নতুন হোস্ট।

  • পাসওয়ার্ড

    স্ট্রিং ঐচ্ছিক

    অনুরোধের জন্য নতুন পাসওয়ার্ড।

  • পথ

    স্ট্রিং ঐচ্ছিক

    অনুরোধের জন্য নতুন পাথ। ফাঁকা থাকলে, আগে থেকে থাকা পাথ মুছে ফেলা হয়।

  • পোর্ট

    স্ট্রিং ঐচ্ছিক

    অনুরোধের জন্য নতুন পোর্ট। ফাঁকা থাকলে, আগে থেকে থাকা পোর্ট মুছে যায়।

  • কোয়েরি

    স্ট্রিং ঐচ্ছিক

    অনুরোধের জন্য নতুন কোয়েরি। এটি খালি থাকতে পারে, সেক্ষেত্রে আগে থেকে থাকা কোয়েরি মুছে যায়; অথবা '?' দিয়ে শুরু হতে পারে।

  • queryTransform

    QueryTransform ঐচ্ছিক

    কোয়েরি কী-ভ্যালু পেয়ার যোগ করুন, সরান বা পরিবর্তন করুন।

  • স্কিম

    স্ট্রিং ঐচ্ছিক

    অনুরোধের জন্য নতুন স্কিম। অনুমোদিত ভ্যালু হল "http", "https", "ftp" এবং "chrome-extension"।

  • ইউজারনেম

    স্ট্রিং ঐচ্ছিক

    অনুরোধের জন্য নতুন ইউজারনেম।

প্রপার্টি

DYNAMIC_RULESET_ID

এক্সটেনশনের মাধ্যমে যোগ করা ডায়নামিক নিয়মের জন্য Ruleset ID।

ভ্যালু

"_dynamic"

GETMATCHEDRULES_QUOTA_INTERVAL

MAX_GETMATCHEDRULES_CALLS_PER_INTERVAL getMatchedRules কল করার সময়সীমা, মিনিটে উল্লেখ করা হয়েছে। অতিরিক্ত কল অবিলম্বে ব্যর্থ হবে এবং runtime.lastError সেট করবে। মনে রাখবেন: getMatchedRules ইউজার জেসচারের সাথে যুক্ত কল কোটার মধ্যে পড়ে না।

ভ্যালু

১০

GUARANTEED_MINIMUM_STATIC_RULES

Chrome 89+

কোনও এক্সটেনশনের চালু থাকা স্ট্যাটিক রুলসেট জুড়ে গ্যারান্টিযুক্ত স্ট্যাটিক নিয়মের ন্যূনতম সংখ্যা। এই সীমার উপরে থাকা যেকোনও নিয়ম গ্লোবাল স্ট্যাটিক নিয়মের সীমা হিসেবে গণনা করা হবে।

ভ্যালু

৩০০০০

MAX_GETMATCHEDRULES_CALLS_PER_INTERVAL

GETMATCHEDRULES_QUOTA_INTERVAL সময়সীমার মধ্যে getMatchedRules-কে যতবার কল করা যাবে।

ভ্যালু

২০

MAX_NUMBER_OF_DYNAMIC_RULES

কোনও এক্সটেনশন সর্বাধিক যতগুলি ডায়নামিক নিয়ম যোগ করতে পারে।

ভ্যালু

৩০০০০

MAX_NUMBER_OF_ENABLED_STATIC_RULESETS

Chrome 94+

কোনও এক্সটেনশন যেকোনও সময় সর্বাধিক যতগুলি স্ট্যাটিক Rulesets চালু করতে পারে।

ভ্যালু

৫০

MAX_NUMBER_OF_REGEX_RULES

কোনও এক্সটেনশন সর্বাধিক যতগুলি রেগুলার এক্সপ্রেশন সংক্রান্ত নিয়ম যোগ করতে পারে। এই সীমা ডায়নামিক নিয়মের সেট এবং নিয়ম রিসোর্স ফাইলে উল্লেখ করা নিয়মের জন্য আলাদাভাবে মূল্যায়ন করা হয়।

ভ্যালু

১০০০

MAX_NUMBER_OF_SESSION_RULES

Chrome 120+

কোনও এক্সটেনশন সেশন স্কোপড নিয়মের সর্বাধিক যতগুলি সংখ্যা যোগ করতে পারে।

ভ্যালু

৫০০০

MAX_NUMBER_OF_STATIC_RULESETS

"rule_resources" ম্যানিফেস্ট কী-এর অংশ হিসেবে কোনও এক্সটেনশন সর্বাধিক যতগুলি স্ট্যাটিক Rulesets নির্দিষ্ট করতে পারে।

ভ্যালু

১০০

MAX_NUMBER_OF_UNSAFE_DYNAMIC_RULES

Chrome 120+

কোনও এক্সটেনশন সর্বাধিক যতগুলি "অনিরাপদ" ডায়নামিক নিয়ম যোগ করতে পারে।

ভ্যালু

৫০০০

MAX_NUMBER_OF_UNSAFE_SESSION_RULES

Chrome 120+

কোনও এক্সটেনশন সর্বাধিক যতগুলি "অসুরক্ষিত" সেশন স্কোপড নিয়ম যোগ করতে পারে।

ভ্যালু

৫০০০

SESSION_RULESET_ID

Chrome 90+

এক্সটেনশনের মাধ্যমে যোগ করা সেশন-স্কোপড নিয়মের জন্য রুলসেট আইডি।

ভ্যালু

"_session"

পদ্ধতি

getAvailableStaticRuleCount()

Promise Chrome 89+ 
chrome.declarativeNetRequest.getAvailableStaticRuleCount(
  callback?: function,
): Promise<number>

গ্লোবাল স্ট্যাটিক রুলের সীমা-তে পৌঁছানোর আগে কোনও এক্সটেনশন যতগুলি স্ট্যাটিক রুল চালু করতে পারে সেই সংখ্যাটি দেখায়।

প্যারামিটারগুলি

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (count: number) => void

    • সংখ্যা

      নম্বর

রিটার্ন

  • Promise<number>

    Chrome 91+

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

getDisabledRuleIds()

Promise Chrome 111+ 
chrome.declarativeNetRequest.getDisabledRuleIds(
  options: GetDisabledRuleIdsOptions,
  callback?: function,
): Promise<number[]>

প্রদত্ত Ruleset-এ বর্তমানে বন্ধ থাকা স্ট্যাটিক নিয়মের তালিকা দেখায়।

প্যারামিটারগুলি

  • বিকল্প

    GetDisabledRuleIdsOptions

    কোয়েরি করার জন্য রুলসেট নির্দিষ্ট করে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (disabledRuleIds: number[]) => void

    • disabledRuleIds

      সংখ্যা[]

রিটার্ন

  • <number[]> প্রমিস

    প্রমিস যা সেই রুলসেটে বন্ধ করা নিয়মের সাথে সম্পর্কিত আইডির তালিকা সহ সমাধান করে।

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

getDynamicRules()

প্রতিশ্রুতি 
chrome.declarativeNetRequest.getDynamicRules(
  filter?: GetRulesFilter,
  callback?: function,
): Promise<Rule[]>

এক্সটেনশনের জন্য ডায়নামিক নিয়মের বর্তমান সেট রিটার্ন করে। কলাররা চাইলে filter উল্লেখ করে ফেচ করা নিয়মের তালিকা ফিল্টার করতে পারেন।

প্যারামিটারগুলি

  • ফিল্টার করুন

    GetRulesFilter ঐচ্ছিক

    Chrome 111+

    ফেচ করা নিয়মের তালিকা ফিল্টার করার অবজেক্ট।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (rules: Rule[]) => void

রিটার্ন

  • প্রতিশ্রুতি<নিয়ম[]>

    Chrome 91+

    প্রমিস যা ডায়নামিক রুলের সেটের সাথে সমাধান করে। সাময়িক ইন্টার্নাল সমস্যার কারণে Promise বাতিল হয়ে যেতে পারে।

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

getEnabledRulesets()

প্রতিশ্রুতি 
chrome.declarativeNetRequest.getEnabledRulesets(
  callback?: function,
): Promise<string[]>

চালু থাকা স্ট্যাটিক রুলসেটের বর্তমান সেটের আইডি দেখায়।

প্যারামিটারগুলি

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (rulesetIds: string[]) => void

    • rulesetIds

      স্ট্রিং[]

রিটার্ন

  • Promise<string[]>

    Chrome 91+

    প্রমিস যা আইডির তালিকা সহ সমাধান করে, যেখানে প্রতিটি আইডি চালু থাকা স্ট্যাটিক Ruleset-এর সাথে সম্পর্কিত।

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

getMatchedRules()

প্রতিশ্রুতি 
chrome.declarativeNetRequest.getMatchedRules(
  filter?: MatchedRulesFilter,
  callback?: function,
): Promise<RulesMatchedDetails>

এক্সটেনশনের জন্য মিলে যাওয়া সব নিয়ম ফিরিয়ে আনে। কলকারী চাইলে filter উল্লেখ করে ম্যাচ করা নিয়মের তালিকা ফিল্টার করতে পারেন। এই পদ্ধতিটি শুধুমাত্র সেইসব এক্সটেনশনের জন্য উপলভ্য যেগুলির "declarativeNetRequestFeedback" অনুমতি আছে বা filter-এ নির্দিষ্ট করা tabId-এর জন্য "activeTab" অনুমতি দেওয়া হয়েছে। মনে রাখবেন: পাঁচ মিনিটের বেশি আগে ম্যাচ করা অ্যাক্টিভ ডকুমেন্টের সাথে যুক্ত নয় এমন নিয়ম ফেরত দেওয়া হবে না।

প্যারামিটারগুলি

  • ফিল্টার করুন

    MatchedRulesFilter ঐচ্ছিক

    মিলে যাওয়া নিয়মের তালিকা ফিল্টার করার অবজেক্ট।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (details: RulesMatchedDetails) => void

রিটার্ন

  • <RulesMatchedDetails> প্রমিস করুন

    Chrome 91+

    মিলে যাওয়া নিয়মের তালিকা ফেচ করা হয়ে গেলে প্রমিজ রিজলভ হয়। কোনও সমস্যা হলে, Promise বাতিল করা হবে। এটি একাধিক কারণে হতে পারে, যেমন পর্যাপ্ত অনুমতি না থাকা বা কোটা পেরিয়ে যাওয়া।

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

getSessionRules()

Promise Chrome 90+ 
chrome.declarativeNetRequest.getSessionRules(
  filter?: GetRulesFilter,
  callback?: function,
): Promise<Rule[]>

এক্সটেনশনের জন্য সেশন স্কোপ করা নিয়মের বর্তমান সেট ফিরিয়ে আনে। কলাররা চাইলে filter উল্লেখ করে ফেচ করা নিয়মের তালিকা ফিল্টার করতে পারেন।

প্যারামিটারগুলি

  • ফিল্টার করুন

    GetRulesFilter ঐচ্ছিক

    Chrome 111+

    ফেচ করা নিয়মের তালিকা ফিল্টার করার অবজেক্ট।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (rules: Rule[]) => void

রিটার্ন

  • প্রতিশ্রুতি<নিয়ম[]>

    Chrome 91+

    সেশন স্কোপড নিয়মের সেট সহ সমাধান করে এমন প্রমিস।

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

isRegexSupported()

Promise Chrome 87+ 
chrome.declarativeNetRequest.isRegexSupported(
  regexOptions: RegexOptions,
  callback?: function,
): Promise<IsRegexSupportedResult>

প্রদত্ত রেগুলার এক্সপ্রেশন regexFilter নিয়মের শর্ত হিসেবে কাজ করবে কিনা তা চেক করে।

প্যারামিটারগুলি

  • regexOptions

    RegexOptions

    চেক করার জন্য রেগুলার এক্সপ্রেশন।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    (result: IsRegexSupportedResult) => void

রিটার্ন

  • Chrome 91+

    রেগুলার এক্সপ্রেশন কাজ করে কিনা এবং না করলে তার কারণ সহ বিবরণ সহ সমাধান করে এমন প্রমিস।

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

setExtensionActionOptions()

Promise Chrome 88+ 
chrome.declarativeNetRequest.setExtensionActionOptions(
  options: ExtensionActionOptions,
  callback?: function,
): Promise<void>

ট্যাবের জন্য অ্যাকশন কাউন্ট এক্সটেনশন অ্যাকশনের ব্যাজ টেক্সট হিসেবে দেখানো হবে কিনা তা কনফিগার করে এবং সেই অ্যাকশন কাউন্ট বাড়ানোর একটি উপায় প্রদান করে।

প্যারামিটারগুলি

  • বিকল্প

    ExtensionActionOptions

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    Chrome 89+

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

রিটার্ন

  • <void> প্রমিস

    Chrome 91+

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

testMatchOutcome()

Promise Chrome 103+ 
chrome.declarativeNetRequest.testMatchOutcome(
  request: TestMatchRequestDetails,
  callback?: function,
): Promise<TestMatchOutcomeResult>

এক্সটেনশনের কোনও declarativeNetRequest নিয়ম কাল্পনিক অনুরোধের সাথে ম্যাচ করবে কিনা তা চেক করে। মনে রাখবেন: শুধুমাত্র আনপ্যাক করা এক্সটেনশনের জন্য উপলভ্য কারণ এটি শুধুমাত্র এক্সটেনশন ডেভেলপমেন্টের সময় ব্যবহার করার জন্য তৈরি করা হয়েছে।

প্যারামিটারগুলি

রিটার্ন

  • প্রতিশ্রুতি<TestMatchOutcomeResult>

    প্রমিস যা মিলে যাওয়া নিয়মের বিবরণ সহ সমাধান করে।

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

updateDynamicRules()

প্রতিশ্রুতি 
chrome.declarativeNetRequest.updateDynamicRules(
  options: UpdateRuleOptions,
  callback?: function,
): Promise<void>

এক্সটেনশনের জন্য ডায়নামিক নিয়মের বর্তমান সেট পরিবর্তন করে। options.removeRuleIds-এ তালিকাভুক্ত আইডি সহ নিয়মগুলি প্রথমে সরানো হয় এবং তারপরে options.addRules-এ দেওয়া নিয়মগুলি যোগ করা হয়। মনে রাখবেন:

  • এই আপডেটটি একটি একক পারমাণবিক অপারেশন হিসাবে ঘটে: হয় সমস্ত নির্দিষ্ট নিয়ম যোগ করা এবং সরানো হয়, অথবা একটি ত্রুটি ফেরত দেওয়া হয়।
  • এইসব নিয়ম ব্রাউজার সেশন ও এক্সটেনশন আপডেট জুড়ে বজায় থাকে।
  • এক্সটেনশন প্যাকেজের অংশ হিসেবে উল্লেখ করা স্ট্যাটিক নিয়ম এই ফাংশন ব্যবহার করে সরানো যাবে না।
  • MAX_NUMBER_OF_DYNAMIC_RULES হল সর্বাধিক সংখ্যক ডাইনামিক নিয়ম যা কোনও এক্সটেনশন যোগ করতে পারে। অসুরক্ষিত নিয়মের সংখ্যা MAX_NUMBER_OF_UNSAFE_DYNAMIC_RULES-এর বেশি হলে চলবে না।

প্যারামিটারগুলি

  • বিকল্প

    UpdateRuleOptions

    Chrome 87+
  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

রিটার্ন

  • <void> প্রমিস

    Chrome 91+

    আপডেট সম্পূর্ণ হলে প্রমিস রিজলভ হয়। কোনও সমস্যা হলে, প্রমিস বাতিল করা হবে এবং রুল সেটে কোনও পরিবর্তন করা হবে না। এটি একাধিক কারণে হতে পারে, যেমন, ভুল নিয়ম ফর্ম্যাট, ডুপ্লিকেট নিয়ম আইডি, নিয়মের সংখ্যা সীমা অতিক্রম করা, ইন্টার্নাল সমস্যা এবং অন্যান্য।

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

updateEnabledRulesets()

প্রতিশ্রুতি 
chrome.declarativeNetRequest.updateEnabledRulesets(
  options: UpdateRulesetOptions,
  callback?: function,
): Promise<void>

এক্সটেনশনের জন্য চালু করা স্ট্যাটিক রুলসেটের সেট আপডেট করে। options.disableRulesetIds-এ তালিকাভুক্ত আইডি সহ রুলসেট প্রথমে সরানো হয় এবং তারপরে options.enableRulesetIds-এ তালিকাভুক্ত রুলসেট যোগ করা হয়। মনে রাখবেন যে চালু করা স্ট্যাটিক রুলসেটের সেট সেশন জুড়ে থাকে তবে এক্সটেনশন আপডেট জুড়ে থাকে না, অর্থাৎ rule_resources ম্যানিফেস্ট কী প্রতিটি এক্সটেনশন আপডেটে চালু করা স্ট্যাটিক রুলসেটের সেট নির্ধারণ করবে।

প্যারামিটারগুলি

  • বিকল্প

    UpdateRulesetOptions

    Chrome 87+
  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

রিটার্ন

  • <void> প্রমিস

    Chrome 91+

    আপডেট সম্পূর্ণ হলে প্রমিস রিজলভ হয়। কোনও সমস্যা হলে, প্রমিস বাতিল করা হবে এবং চালু থাকা রুলসেটের সেটে কোনও পরিবর্তন করা হবে না। এটি একাধিক কারণে হতে পারে, যেমন ভুল রুলসেট আইডি, নিয়মের সংখ্যা সীমা অতিক্রম করা বা ইন্টার্নাল সমস্যা।

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

updateSessionRules()

Promise Chrome 90+ 
chrome.declarativeNetRequest.updateSessionRules(
  options: UpdateRuleOptions,
  callback?: function,
): Promise<void>

এক্সটেনশনের জন্য সেশন স্কোপড নিয়মের বর্তমান সেট পরিবর্তন করে। options.removeRuleIds-এ তালিকাভুক্ত আইডি সহ নিয়মগুলি প্রথমে সরানো হয় এবং তারপরে options.addRules-এ দেওয়া নিয়মগুলি যোগ করা হয়। মনে রাখবেন:

  • এই আপডেটটি একটি একক পারমাণবিক অপারেশন হিসাবে ঘটে: হয় সমস্ত নির্দিষ্ট নিয়ম যোগ করা এবং সরানো হয়, অথবা একটি ত্রুটি ফেরত দেওয়া হয়।
  • এইসব নিয়ম সেশন জুড়ে বজায় থাকে না এবং মেমরিতে ব্যাক-আপ নেওয়া হয়।
  • MAX_NUMBER_OF_SESSION_RULES হল সেশন নিয়মের সর্বাধিক সংখ্যা যা কোনও এক্সটেনশন যোগ করতে পারে।

প্যারামিটারগুলি

  • বিকল্প

    UpdateRuleOptions

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

রিটার্ন

  • <void> প্রমিস

    Chrome 91+

    আপডেট সম্পূর্ণ হলে প্রমিস রিজলভ হয়। কোনও সমস্যা হলে, প্রমিস বাতিল করা হবে এবং রুল সেটে কোনও পরিবর্তন করা হবে না। এটি একাধিক কারণে হতে পারে, যেমন ভুল নিয়মের ফর্ম্যাট, ডুপ্লিকেট নিয়ম আইডি, নিয়মের সংখ্যা সীমা অতিক্রম করা এবং অন্যান্য।

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

updateStaticRules()

Promise Chrome 111+ 
chrome.declarativeNetRequest.updateStaticRules(
  options: UpdateStaticRulesOptions,
  callback?: function,
): Promise<void>

Ruleset-এ আলাদা আলাদা স্ট্যাটিক নিয়ম বন্ধ ও চালু করে। বন্ধ থাকা Ruleset-এর নিয়মে পরিবর্তন করা হলে, সেটি আবার চালু করার সময় থেকে কার্যকর হবে।

প্যারামিটারগুলি

  • বিকল্প

    UpdateStaticRulesOptions

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি দেখতে এইরকম: 

    () => void

রিটার্ন

  • <void> প্রমিস

    আপডেট সম্পূর্ণ হলে প্রমিস রিজলভ হয়। কোনও সমস্যা হলে, প্রমিস বাতিল করা হবে এবং চালু থাকা স্ট্যাটিক নিয়মে কোনও পরিবর্তন করা হবে না।

    Manifest V3 এবং তার পরবর্তী ভার্সনের জন্য শুধু প্রমিস কাজ করে, অন্যান্য প্ল্যাটফর্মের ক্ষেত্রে কলব্যাক ব্যবহার করতে হবে।

ইভেন্ট

onRuleMatchedDebug

chrome.declarativeNetRequest.onRuleMatchedDebug.addListener(
  callback: function,
)

কোনও অনুরোধের সাথে নিয়ম মিলে গেলে ফায়ার করা হয়। শুধুমাত্র "declarativeNetRequestFeedback" অনুমতি সহ আনপ্যাক করা এক্সটেনশনের জন্য উপলভ্য কারণ এটি শুধুমাত্র ডিবাগিংয়ের উদ্দেশ্যে ব্যবহার করার জন্য তৈরি করা হয়েছে।

প্যারামিটারগুলি