chrome.declarativeNetRequest

বর্ণনা

অনুমতি

" declarativeNetRequest " এবং " declarativeNetRequestWithHostAccess " অনুমতি একই ক্ষমতা প্রদান করে৷ তাদের মধ্যে পার্থক্য হল যখন অনুমতি অনুরোধ করা হয় বা দেওয়া হয়।

"declarativeNetRequest"

ইনস্টল করার সময় একটি অনুমতি সতর্কতা ট্রিগার করে কিন্তু allow , allowAllRequests এবং block নিয়মগুলির অন্তর্নিহিত অ্যাক্সেস প্রদান করে৷ হোস্টগুলিতে সম্পূর্ণ অ্যাক্সেসের অনুরোধ করার প্রয়োজন এড়াতে যখন সম্ভব তখন এটি ব্যবহার করুন।

"declarativeNetRequestFeedback"

আনপ্যাক করা এক্সটেনশনগুলির জন্য ডিবাগিং বৈশিষ্ট্যগুলি সক্ষম করে, বিশেষত getMatchedRules() এবং onRuleMatchedDebug ৷

"declarativeNetRequestWithHostAccess"

একটি অনুমতি সতর্কতা ইনস্টল করার সময় দেখানো হয় না, কিন্তু আপনি একটি হোস্টে কোনো কাজ সম্পাদন করার আগে আপনাকে হোস্ট অনুমতির অনুরোধ করতে হবে। এটি উপযুক্ত যখন আপনি একটি এক্সটেনশনে ঘোষণামূলক নেট অনুরোধের নিয়মগুলি ব্যবহার করতে চান যার ইতিমধ্যেই অতিরিক্ত সতর্কতা তৈরি না করে হোস্টের অনুমতি রয়েছে৷

প্রাপ্যতা

উদ্ভাসিত

পূর্বে বর্ণিত অনুমতিগুলি ছাড়াও, নির্দিষ্ট ধরণের নিয়মসেট, স্ট্যাটিক নিয়মসেটগুলির জন্য বিশেষভাবে "declarative_net_request" ম্যানিফেস্ট কী ঘোষণা করতে হবে, যা "rule_resources" নামক একক কী সহ একটি অভিধান হওয়া উচিত। এই কী হল একটি বিন্যাস যার মধ্যে 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" কী ব্যবহার করে আইডিগুলিকে সংজ্ঞায়িত করা হয়। 5000 অক্ষম স্ট্যাটিক নিয়মের সর্বোচ্চ সীমা আছে।

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

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

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

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

ইউআরএল মিল

ডিক্লারেটিভ নেট রিকোয়েস্ট একটি প্যাটার্ন ম্যাচিং সিনট্যাক্স বা রেগুলার এক্সপ্রেশনের সাথে ইউআরএল মেলানোর ক্ষমতা প্রদান করে।

ইউআরএল ফিল্টার সিনট্যাক্স

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

নিয়মিত অভিব্যক্তি

শর্তগুলিও রেগুলার এক্সপ্রেশন ব্যবহার করতে পারে। "regexFilter" কী দেখুন। এই শর্তগুলির জন্য প্রযোজ্য সীমা সম্পর্কে জানতে, রেগুলার এক্সপ্রেশন ব্যবহার করে এমন নিয়মগুলি দেখুন।

ভাল URL শর্ত লিখুন

একটি সম্পূর্ণ ডোমেনের সাথে মেলে এমন নিয়ম লেখার সময় যত্ন নিন। অন্যথায়, আপনার নিয়ম অপ্রত্যাশিত পরিস্থিতিতে মিলতে পারে। উদাহরণস্বরূপ, প্যাটার্ন ম্যাচিং সিনট্যাক্স ব্যবহার করার সময়:

• google.com ভুলভাবে https://example.com/?param=google.com সাথে মেলে
• ||google.com ভুলভাবে https://google.company সাথে মেলে
• https://www.google.com ভুলভাবে মেলে https://example.com/?param=https://www.google.com

ব্যবহার বিবেচনা করুন:

• ||google.com/ , যা সমস্ত পাথ এবং সমস্ত সাবডোমেনের সাথে মেলে৷
• |https://www.google.com/ যা সমস্ত পাথের সাথে মেলে এবং কোনো সাবডোমেন নেই৷

একইভাবে, রেগুলার এক্সপ্রেশন অ্যাঙ্কর করতে ^ এবং / অক্ষর ব্যবহার করুন। উদাহরণস্বরূপ, ^https:\/\/www\.google\.com\/ https://www.google.com-এর যেকোনো পাথের সাথে মেলে।

নিয়ম মূল্যায়ন

নেটওয়ার্ক অনুরোধ জীবনচক্রের বিভিন্ন পর্যায়ে ব্রাউজার দ্বারা DNR নিয়ম প্রয়োগ করা হয়।

অনুরোধের আগে

একটি অনুরোধ করার আগে, একটি এক্সটেনশন একটি ম্যাচিং নিয়মের সাথে এটিকে ব্লক বা রিডাইরেক্ট করতে পারে (স্কিমটিকে HTTP থেকে HTTPS-এ আপগ্রেড করা সহ)।

প্রতিটি এক্সটেনশনের জন্য, ব্রাউজার মিলিত নিয়মের একটি তালিকা নির্ধারণ করে। একটি modifyHeaders অ্যাকশন সহ নিয়মগুলি এখানে অন্তর্ভুক্ত করা হয়নি কারণ সেগুলি পরে পরিচালনা করা হবে৷ অতিরিক্তভাবে, responseHeaders কন্ডিশন সহ নিয়মগুলি পরে বিবেচনা করা হবে (যখন রেসপন্স হেডার উপলব্ধ থাকে) এবং অন্তর্ভুক্ত করা হয় না।

তারপর, প্রতিটি এক্সটেনশনের জন্য, Chrome প্রতি অনুরোধে সর্বাধিক একজন প্রার্থীকে বেছে নেয়। ক্রোম একটি মিলে যাওয়া নিয়ম খুঁজে পায়, সমস্ত মিলে যাওয়া নিয়মগুলিকে অগ্রাধিকার দিয়ে অর্ডার করে৷ একই অগ্রাধিকার সহ নিয়মগুলি ক্রিয়া দ্বারা আদেশ করা হয় ( allow বা allowAllRequests > block > upgradeScheme > redirect )।

প্রার্থী যদি একটি allow বা allowAllRequests নিয়ম হয়, অথবা যে ফ্রেমে অনুরোধটি করা হচ্ছে সেটি এই এক্সটেনশন থেকে উচ্চতর বা সমান অগ্রাধিকারের একটি allowAllRequests নিয়মের সাথে মিলে যায়, তাহলে অনুরোধটি "অনুমতিপ্রাপ্ত" হয় এবং এক্সটেনশন অনুরোধের উপর কোনো প্রভাব ফেলবে না।

যদি একাধিক এক্সটেনশন এই অনুরোধটিকে ব্লক বা পুনঃনির্দেশ করতে চায়, তবে একটি একক পদক্ষেপ নেওয়ার জন্য বেছে নেওয়া হয়। ক্রম block > redirect বা upgradeScheme > allow বা allowAllRequests এ নিয়মগুলি সাজানোর মাধ্যমে Chrome এটি করে। যদি দুটি নিয়ম একই ধরনের হয়, Chrome সাম্প্রতিক ইনস্টল করা এক্সটেনশন থেকে নিয়মটি বেছে নেয়।

অনুরোধ শিরোনাম পাঠানো হয় আগে

Chrome সার্ভারে অনুরোধ শিরোনাম পাঠানোর আগে, শিরোনামগুলি আপডেট করা হয় modifyHeaders নিয়মের সাথে মিল রেখে।

একটি একক এক্সটেনশনের মধ্যে, Chrome সমস্ত মিলে যাওয়া modifyHeaders নিয়মগুলি খুঁজে বের করে সম্পাদন করার জন্য পরিবর্তনগুলির তালিকা তৈরি করে৷ আগের মতই, শুধুমাত্র যে নিয়মগুলিকে যেকোন মিলের চেয়ে বেশি অগ্রাধিকার দেওয়া হয়েছে allow বা allowAllRequests নিয়মগুলি অন্তর্ভুক্ত করা হয়েছে৷

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

• যদি একটি নিয়ম একটি শিরোলেখের সাথে যুক্ত হয়, তাহলে নিম্ন অগ্রাধিকারের নিয়মগুলি শুধুমাত্র সেই শিরোলেখের সাথে যুক্ত হতে পারে। সেট এবং অপসারণ অপারেশন অনুমোদিত নয়.
• যদি একটি নিয়ম একটি শিরোনাম সেট করে, তবে একই এক্সটেনশন থেকে শুধুমাত্র নিম্ন অগ্রাধিকারের নিয়মগুলি সেই শিরোলেখের সাথে যুক্ত করা যেতে পারে। অন্য কোন পরিবর্তন অনুমোদিত নয়.
• যদি একটি নিয়ম একটি শিরোনাম অপসারণ করে, তাহলে নিম্ন অগ্রাধিকারের নিয়মগুলি শিরোনামটিকে আরও সংশোধন করতে পারে না।

একবার একটি প্রতিক্রিয়া পাওয়া যায়

একবার প্রতিক্রিয়া শিরোনামগুলি পাওয়া গেলে, Chrome একটি responseHeaders শর্ত সহ নিয়মগুলি মূল্যায়ন করে৷

এই নিয়মগুলিকে action এবং priority অনুসারে বাছাই করার পরে এবং একটি মিলিত allow বা allowAllRequests সমস্ত অনুরোধ নিয়মের দ্বারা অপ্রয়োজনীয় করে দেওয়া নিয়মগুলি বাদ দেওয়ার পরে (এটি "অনুরোধের আগে"-এর ধাপগুলির সাথে একইভাবে ঘটে), Chrome একটি এক্সটেনশনের পক্ষ থেকে অনুরোধটিকে ব্লক বা রিডাইরেক্ট করতে পারে।

মনে রাখবেন যে এই পর্যায়ে একটি অনুরোধ করা হলে, অনুরোধটি ইতিমধ্যেই সার্ভারে পাঠানো হয়েছে এবং সার্ভার অনুরোধের বডির মতো ডেটা পেয়েছে। একটি রেসপন্স হেডার কন্ডিশন সহ একটি ব্লক বা রিডাইরেক্ট নিয়ম এখনও চলবে-কিন্তু আসলে অনুরোধটিকে ব্লক বা রিডাইরেক্ট করতে পারবে না।

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

যদি অনুরোধটি ব্লক বা পুনঃনির্দেশিত না হয়, Chrome যেকোনও modifyHeaders নিয়ম প্রয়োগ করে। প্রতিক্রিয়া শিরোনামগুলিতে পরিবর্তনগুলি প্রয়োগ করা "অনুরোধ শিরোনাম পাঠানোর আগে" তে বর্ণিত একইভাবে কাজ করে। অনুরোধের শিরোনামগুলিতে পরিবর্তনগুলি প্রয়োগ করা কিছুই করে না, যেহেতু অনুরোধটি ইতিমধ্যেই করা হয়েছে৷

নিরাপদ নিয়ম

নিরাপদ নিয়মগুলি block , allow , allowAllRequests বা upgradeScheme এর একটি ক্রিয়া সহ নিয়ম হিসাবে সংজ্ঞায়িত করা হয়। এই নিয়মগুলি একটি বর্ধিত গতিশীল নিয়মের কোটা সাপেক্ষে।

নিয়ম সীমা

ব্রাউজারে নিয়ম লোড করা এবং মূল্যায়ন করার জন্য একটি কর্মক্ষমতা ওভারহেড আছে, তাই API ব্যবহার করার সময় কিছু সীমা প্রযোজ্য। সীমাগুলি আপনি যে নিয়ম ব্যবহার করছেন তার উপর নির্ভর করে।

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

স্ট্যাটিক নিয়মগুলি হল ম্যানিফেস্ট ফাইলে ঘোষিত নিয়ম ফাইলগুলিতে নির্দিষ্ট করা৷ একটি এক্সটেনশন "rule_resources" ম্যানিফেস্ট কী-এর অংশ হিসাবে 100টি পর্যন্ত স্ট্যাটিক নিয়মসেট নির্দিষ্ট করতে পারে, কিন্তু এই নিয়মগুলির মধ্যে মাত্র 50টি একবারে সক্ষম করা যেতে পারে৷ পরবর্তীটিকে MAX_NUMBER_OF_ENABLED_STATIC_RULESETS বলা হয়। সম্মিলিতভাবে, সেই নিয়মগুলি কমপক্ষে 30,000 নিয়মের গ্যারান্টিযুক্ত। একে বলা হয় GUARANTEED_MINIMUM_STATIC_RULES ।

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

সেশনের নিয়ম

একটি এক্সটেনশনে 5000 সেশনের নিয়ম থাকতে পারে। এটি MAX_NUMBER_OF_SESSION_RULES হিসাবে প্রকাশিত হয়েছে।

Chrome 120-এর আগে, 5000টি সম্মিলিত ডায়নামিক এবং সেশন নিয়মের সীমা ছিল।

গতিশীল নিয়ম

একটি এক্সটেনশনে কমপক্ষে 5000টি গতিশীল নিয়ম থাকতে পারে। এটি MAX_NUMBER_OF_UNSAFE_DYNAMIC_RULES হিসাবে প্রকাশিত হয়েছে।

Chrome 121 থেকে শুরু করে, নিরাপদ গতিশীল নিয়মগুলির জন্য 30,000 নিয়মের একটি বৃহত্তর সীমা রয়েছে, যা MAX_NUMBER_OF_DYNAMIC_RULES হিসাবে প্রকাশ করা হয়েছে। 5000 এর সীমার মধ্যে যে কোনো অনিরাপদ নিয়ম যোগ করা হলে তাও এই সীমার মধ্যে গণনা করা হবে।

Chrome 120 এর আগে, একটি 5000 সম্মিলিত গতিশীল এবং সেশন নিয়ম সীমা ছিল।

নিয়ম যা রেগুলার এক্সপ্রেশন ব্যবহার করে

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

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

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" অ্যারে ব্যবহার করুন।

হেডার পরিবর্তন

যুক্ত করার ক্রিয়াকলাপটি শুধুমাত্র নিম্নলিখিত শিরোনামগুলির জন্য সমর্থিত: accept , accept-encoding , accept-language , access-control-request-headers , cache-control , connection , content-language , cookie , forwarded , if-match , if-none-match হয় , keep-alive , range , te , trailer transfer-encoding ট্রান্সফার , upgrade user-agent , via , want-digest , x-forwarded-for ।

উদাহরণ

কোড উদাহরণ

গতিশীল নিয়ম আপডেট করুন

নিম্নলিখিত উদাহরণ দেখায় কিভাবে 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-এ নেভিগেশন

দুটি নিয়ম এই ইউআরএল কভার করে: আইডি 1 এবং 4 এর নিয়ম। আইডি 1 এর নিয়মটি প্রযোজ্য কারণ "redirect" অ্যাকশনের চেয়ে "block" অ্যাকশনের অগ্রাধিকার বেশি। বাকি নিয়মগুলি প্রযোজ্য নয় কারণ সেগুলি দীর্ঘ URL এর জন্য৷

https://google.com/1234-এ নেভিগেশন

দীর্ঘ ইউআরএলের কারণে, আইডি 2-এর নিয়মটি এখন আইডি 1 এবং 4-এর নিয়মগুলির সাথে মেলে। আইডি 2-এর নিয়মটি প্রযোজ্য কারণ "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/* ।

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

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

উদাহরণ.com-এর একটি সাবডোমেনে পুনঃনির্দেশিত করতে নিম্নলিখিত "transform" কী ব্যবহার করে। এটি example.com থেকে যেকোনো স্কিমের সাথে অনুরোধগুলিকে আটকাতে একটি ডোমেন নাম অ্যাঙ্কর ("||") ব্যবহার করে৷ "scheme" "transform" "-এ "স্কিম" কী নির্দিষ্ট করে যে সাবডোমেনে পুনঃনির্দেশ সর্বদা "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" ব্যবহার করে রেগুলার এক্সপ্রেশনের প্রথম প্রত্যাবর্তিত মিল নির্দিষ্ট করে। এই ক্ষেত্রে, "abc" পুনঃনির্দেশিত URL থেকে ক্যাপচার করা হয় এবং প্রতিস্থাপনে স্থাপন করা হয়।

{
  "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"] }
}

chrome.declarativeNetRequest.getAvailableStaticRuleCount(): Promise<number>

chrome.declarativeNetRequest.getDisabledRuleIds(
  options: GetDisabledRuleIdsOptions,
): Promise<number[]>

chrome.declarativeNetRequest.getDynamicRules(
  filter?: GetRulesFilter,
): Promise<Rule[]>

chrome.declarativeNetRequest.getEnabledRulesets(): Promise<string[]>

chrome.declarativeNetRequest.getMatchedRules(
  filter?: MatchedRulesFilter,
): Promise<RulesMatchedDetails>

chrome.declarativeNetRequest.getSessionRules(
  filter?: GetRulesFilter,
): Promise<Rule[]>

chrome.declarativeNetRequest.isRegexSupported(
  regexOptions: RegexOptions,
): Promise<IsRegexSupportedResult>

chrome.declarativeNetRequest.setExtensionActionOptions(
  options: ExtensionActionOptions,
): Promise<void>

chrome.declarativeNetRequest.testMatchOutcome(
  request: TestMatchRequestDetails,
): Promise<TestMatchOutcomeResult>

chrome.declarativeNetRequest.updateDynamicRules(
  options: UpdateRuleOptions,
): Promise<void>

chrome.declarativeNetRequest.updateEnabledRulesets(
  options: UpdateRulesetOptions,
): Promise<void>

chrome.declarativeNetRequest.updateSessionRules(
  options: UpdateRuleOptions,
): Promise<void>

chrome.declarativeNetRequest.updateStaticRules(
  options: UpdateStaticRulesOptions,
): Promise<void>

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