বর্ণনা
দ্রষ্টব্য: এই API বন্ধ করা হয়েছে। পরিবর্তে declarativeNetRequest
API দেখুন। ইন-ফ্লাইট অনুরোধগুলিকে আটকাতে, ব্লক করতে বা সংশোধন করতে chrome.declarativeWebRequest
API ব্যবহার করুন৷ এটি chrome.webRequest
API-এর তুলনায় উল্লেখযোগ্যভাবে দ্রুত কারণ আপনি জাভাস্ক্রিপ্ট ইঞ্জিনের পরিবর্তে ব্রাউজারে মূল্যায়ন করা নিয়ম নিবন্ধন করতে পারেন, যা রাউন্ডট্রিপ লেটেন্সি হ্রাস করে এবং উচ্চ দক্ষতার অনুমতি দেয়।
অনুমতি
declarativeWebRequest
হোস্ট অনুমতি সহ এই API ব্যবহার করার জন্য আপনাকে এক্সটেনশন ম্যানিফেস্টে "declarativeWebRequest" অনুমতি ঘোষণা করতে হবে।
{
"name": "My extension",
...
"permissions": [
"declarativeWebRequest",
"*://*/*"
],
...
}
প্রাপ্যতা
উদ্ভাসিত
মনে রাখবেন যে নির্দিষ্ট ধরণের অ-সংবেদনশীল ক্রিয়াগুলির জন্য হোস্টের অনুমতির প্রয়োজন হয় না:
-
CancelRequest
-
IgnoreRules
-
RedirectToEmptyDocument
-
RedirectToTransparentImage
SendMessageToExtension()
অ্যাকশনের জন্য যে কোনো হোস্টের জন্য হোস্টের অনুমতি প্রয়োজন যাদের নেটওয়ার্ক অনুরোধে আপনি একটি বার্তা ট্রিগার করতে চান।
অন্যান্য সমস্ত কর্মের জন্য সমস্ত URL-এর হোস্ট অনুমতি প্রয়োজন৷
উদাহরণ স্বরূপ, যদি "https://*.google.com/*"
হয় একমাত্র হোস্টের অনুমতি একটি এক্সটেনশনের, তাহলে এই ধরনের এক্সটেনশন একটি নিয়ম সেট আপ করতে পারে:
-
https://www.google.com
বাhttps://anything.else.com
এ একটি অনুরোধ বাতিল করুন। -
https://www.google.com
এ নেভিগেট করার সময় একটি বার্তা পাঠান কিন্তুhttps://something.else.com
এ নয়।
এক্সটেনশনটি https://www.google.com
কে https://mail.google.com
এ পুনঃনির্দেশিত করার জন্য একটি নিয়ম সেট আপ করতে পারে না।
নিয়ম
ডিক্লারেটিভ ওয়েব রিকোয়েস্ট এপিআই ডিক্লারেটিভ এপিআই- এর ধারণা অনুসরণ করে। আপনি chrome.declarativeWebRequest.onRequest
ইভেন্ট অবজেক্টে নিয়ম নিবন্ধন করতে পারেন।
ডিক্লারেটিভ ওয়েব রিকোয়েস্ট এপিআই একটি একক ধরনের মিল মানদণ্ড সমর্থন করে, RequestMatcher
। RequestMatcher
নেটওয়ার্ক অনুরোধের সাথে মেলে যদি এবং শুধুমাত্র যদি সমস্ত তালিকাভুক্ত মানদণ্ড পূরণ করা হয়। ব্যবহারকারী যখন ওমিনিবক্সে https://www.example.com
এ প্রবেশ করবে তখন নিম্নলিখিত RequestMatcher
একটি নেটওয়ার্ক অনুরোধের সাথে মিলবে:
var matcher = new chrome.declarativeWebRequest.RequestMatcher({
url: { hostSuffix: 'example.com', schemes: ['http'] },
resourceType: ['main_frame']
});
এই স্কিমের কারণে https://www.example.com
এর অনুরোধ RequestMatcher
দ্বারা প্রত্যাখ্যান করা হবে। এছাড়াও একটি এমবেডেড আইফ্রেমের জন্য সমস্ত অনুরোধ resourceType
কারণে প্রত্যাখ্যান করা হবে।
"example.com"-এ সমস্ত অনুরোধ বাতিল করতে, আপনি নিম্নরূপ একটি নিয়ম সংজ্ঞায়িত করতে পারেন:
var rule = {
conditions: [
new chrome.declarativeWebRequest.RequestMatcher({
url: { hostSuffix: 'example.com' } })
],
actions: [
new chrome.declarativeWebRequest.CancelRequest()
]
};
example.com
এবং foobar.com
এ সমস্ত অনুরোধ বাতিল করতে, আপনি একটি দ্বিতীয় শর্ত যোগ করতে পারেন, কারণ প্রতিটি শর্ত সমস্ত নির্দিষ্ট ক্রিয়া ট্রিগার করার জন্য যথেষ্ট:
var rule2 = {
conditions: [
new chrome.declarativeWebRequest.RequestMatcher({
url: { hostSuffix: 'example.com' } }),
new chrome.declarativeWebRequest.RequestMatcher({
url: { hostSuffix: 'foobar.com' } })
],
actions: [
new chrome.declarativeWebRequest.CancelRequest()
]
};
নিম্নলিখিত নিয়ম নিবন্ধন করুন:
chrome.declarativeWebRequest.onRequest.addRules([rule2]);
শর্ত এবং কর্মের মূল্যায়ন
ডিক্লারেটিভ ওয়েব রিকোয়েস্ট এপিআই ওয়েব রিকোয়েস্ট এপিআই- এর ওয়েব রিকোয়েস্টের জন্য লাইফ সাইকেল মডেল অনুসরণ করে। এর মানে হল যে শর্তগুলি শুধুমাত্র একটি ওয়েব অনুরোধের নির্দিষ্ট পর্যায়ে পরীক্ষা করা যেতে পারে এবং একইভাবে, কর্মগুলি শুধুমাত্র নির্দিষ্ট পর্যায়ে কার্যকর করা যেতে পারে। নিম্নলিখিত সারণী অনুরোধের পর্যায়গুলি তালিকাভুক্ত করে যা শর্ত এবং কর্মের সাথে সামঞ্জস্যপূর্ণ।
শর্তের বৈশিষ্ট্যগুলি প্রক্রিয়া করা যেতে পারে এমন পর্যায়ে অনুরোধ করুন৷ | ||||
---|---|---|---|---|
শর্ত বৈশিষ্ট্য | অন বিফোর রিকোয়েস্ট | onBeforeSendHeaders | onHeaders প্রাপ্ত | onAuthRequired |
url | ✓ | ✓ | ✓ | ✓ |
resourceType | ✓ | ✓ | ✓ | ✓ |
contentType | ✓ | |||
excludeContentType | ✓ | |||
responseHeaders | ✓ | |||
excludeResponseHeaders | ✓ | |||
requestHeaders | ✓ | |||
excludeRequestHeaders | ✓ | |||
thirdPartyForCookies | ✓ | ✓ | ✓ | ✓ |
অনুরোধের পর্যায়গুলি যেখানে কর্ম সম্পাদন করা যেতে পারে। | ||||
ঘটনা | অন বিফোর রিকোয়েস্ট | onBeforeSendHeaders | onHeaders প্রাপ্ত | onAuthRequired |
AddRequestCookie | ✓ | |||
AddResponseCookie | ✓ | |||
AddResponseHeader | ✓ | |||
CancelRequest | ✓ | ✓ | ✓ | ✓ |
EditRequestCookie | ✓ | |||
EditResponseCookie | ✓ | |||
IgnoreRules | ✓ | ✓ | ✓ | ✓ |
RedirectByRegEx | ✓ | ✓ | ||
RedirectRequest | ✓ | ✓ | ||
RedirectToEmptyDocument | ✓ | ✓ | ||
RedirectToTransparentImage | ✓ | ✓ | ||
RemoveRequestCookie | ✓ | |||
RemoveRequestHeader | ✓ | |||
RemoveResponseCookie | ✓ | |||
RemoveResponseHeader | ✓ | |||
SendMessageToExtension | ✓ | ✓ | ✓ | ✓ |
SetRequestHeader | ✓ |
নিয়ম ওভাররাইড করতে অগ্রাধিকার ব্যবহার করুন
ইভেন্ট API- এ বর্ণিত অগ্রাধিকারের সাথে নিয়মগুলি যুক্ত করা যেতে পারে৷ এই পদ্ধতিটি ব্যতিক্রম প্রকাশ করতে ব্যবহার করা যেতে পারে। নিম্নলিখিত উদাহরণটি "myserver.com" সার্ভার ব্যতীত evil.jpg
নামের ইমেজের সমস্ত অনুরোধ ব্লক করে।
var rule1 = {
priority: 100,
conditions: [
new chrome.declarativeWebRequest.RequestMatcher({
url: { pathEquals: 'evil.jpg' } })
],
actions: [
new chrome.declarativeWebRequest.CancelRequest()
]
};
var rule2 = {
priority: 1000,
conditions: [
new chrome.declarativeWebRequest.RequestMatcher({
url: { hostSuffix: '.myserver.com' } })
],
actions: [
new chrome.declarativeWebRequest.IgnoreRules({
lowerPriorityThan: 1000 })
]
};
chrome.declarativeWebRequest.onRequest.addRules([rule1, rule2]);
এটা স্বীকার করা গুরুত্বপূর্ণ যে IgnoreRules
অ্যাকশন অনুরোধের ধাপে টিকে থাকে না। একটি ওয়েব অনুরোধের প্রতিটি পর্যায়ে সমস্ত নিয়মের সমস্ত শর্ত মূল্যায়ন করা হয়। যদি একটি IgnoreRules
অ্যাকশন কার্যকর করা হয়, তবে এটি শুধুমাত্র অন্যান্য অ্যাকশনের ক্ষেত্রে প্রযোজ্য যা একই স্টেজে একই ওয়েব অনুরোধের জন্য সম্পাদিত হয়।
প্রকারভেদ
AddRequestCookie
অনুরোধে একটি কুকি যোগ করে বা একটি কুকি ওভাররাইড করে, যদি একই নামের আরেকটি কুকি ইতিমধ্যেই বিদ্যমান থাকে। মনে রাখবেন যে এটি কুকিজ API ব্যবহার করতে পছন্দ করে কারণ এটি গণনাগতভাবে কম ব্যয়বহুল।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: AddRequestCookie) => {...}
- রিটার্ন
- কুকি
অনুরোধে যোগ করতে হবে কুকি। কোনো ক্ষেত্র অনির্ধারিত হতে পারে।
AddResponseCookie
প্রতিক্রিয়াতে একটি কুকি যোগ করে বা একটি কুকি ওভাররাইড করে, যদি একই নামের অন্য একটি কুকি ইতিমধ্যেই বিদ্যমান থাকে। মনে রাখবেন যে এটি কুকিজ API ব্যবহার করতে পছন্দ করে কারণ এটি গণনাগতভাবে কম ব্যয়বহুল।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: AddResponseCookie) => {...}
- রিটার্ন
- কুকি
কুকি প্রতিক্রিয়া যোগ করা. নাম এবং মান উল্লেখ করা প্রয়োজন।
AddResponseHeader
এই ওয়েব অনুরোধের প্রতিক্রিয়ায় প্রতিক্রিয়া শিরোনাম যোগ করে। যেহেতু একাধিক প্রতিক্রিয়া শিরোনাম একই নাম ভাগ করতে পারে, তাই আপনাকে প্রথমে সরাতে হবে এবং তারপর একটি প্রতিস্থাপন করার জন্য একটি নতুন প্রতিক্রিয়া শিরোনাম যোগ করতে হবে।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: AddResponseHeader) => {...}
- রিটার্ন
- নাম
স্ট্রিং
HTTP প্রতিক্রিয়া শিরোনাম নাম.
- মান
স্ট্রিং
HTTP প্রতিক্রিয়া হেডার মান।
CancelRequest
ঘোষণামূলক ইভেন্ট অ্যাকশন যা একটি নেটওয়ার্ক অনুরোধ বাতিল করে।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: CancelRequest) => {...}
- রিটার্ন
EditRequestCookie
অনুরোধের এক বা একাধিক কুকি সম্পাদনা করুন। মনে রাখবেন যে এটি কুকিজ API ব্যবহার করতে পছন্দ করে কারণ এটি গণনাগতভাবে কম ব্যয়বহুল।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: EditRequestCookie) => {...}
- রিটার্ন
- ফিল্টার
কুকির জন্য ফিল্টার যা সংশোধন করা হবে। সমস্ত খালি এন্ট্রি উপেক্ষা করা হয়.
- পরিবর্তন
ফিল্টার ম্যাচ করা কুকিগুলিতে ওভাররাইড করা হবে এমন বৈশিষ্ট্যগুলি৷ একটি খালি স্ট্রিং সেট করা বৈশিষ্ট্যগুলি সরানো হয়.
EditResponseCookie
প্রতিক্রিয়ার এক বা একাধিক কুকি সম্পাদনা করুন। মনে রাখবেন যে এটি কুকিজ API ব্যবহার করতে পছন্দ করে কারণ এটি গণনাগতভাবে কম ব্যয়বহুল।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: EditResponseCookie) => {...}
- রিটার্ন
- ফিল্টার
কুকির জন্য ফিল্টার যা সংশোধন করা হবে। সমস্ত খালি এন্ট্রি উপেক্ষা করা হয়.
- পরিবর্তন
ফিল্টার ম্যাচ করা কুকিগুলিতে ওভাররাইড করা হবে এমন বৈশিষ্ট্যগুলি৷ একটি খালি স্ট্রিং সেট করা বৈশিষ্ট্যগুলি সরানো হয়.
FilterResponseCookie
HTTP প্রতিক্রিয়াগুলিতে একটি কুকির একটি ফিল্টার৷
বৈশিষ্ট্য
- বয়স নিম্নসীমা
সংখ্যা ঐচ্ছিক
কুকি লাইফটাইমে অন্তর্ভুক্ত নিম্ন আবদ্ধ (বর্তমান সময়ের পরে সেকেন্ডে নির্দিষ্ট)। শুধুমাত্র সেই কুকিজ যার মেয়াদ শেষ হওয়ার তারিখ-সময় 'এখন + বয়স নিম্নমুখী' বা পরে এই মানদণ্ডটি পূরণ করে। সেশন কুকিজ এই ফিল্টারের মানদণ্ড পূরণ করে না। কুকির জীবনকাল হয় 'সর্বোচ্চ বয়স' বা 'মেয়াদ শেষ' কুকি বৈশিষ্ট্য থেকে গণনা করা হয়। উভয়ই নির্দিষ্ট করা থাকলে, কুকির জীবনকাল গণনা করতে 'সর্বোচ্চ বয়স' ব্যবহার করা হয়।
- বয়স ঊর্ধ্বমুখী
সংখ্যা ঐচ্ছিক
কুকির লাইফটাইমে ইনক্লুসিভ আপার বাউন্ড (বর্তমান সময়ের পর সেকেন্ডে নির্দিষ্ট)। শুধুমাত্র কুকি যেগুলির মেয়াদ শেষ হওয়ার তারিখ-সময় ব্যবধানের মধ্যে রয়েছে [এখন, এখন + বয়স-উপরবাউন্ড] এই মানদণ্ডটি পূরণ করে। সেশন কুকি এবং কুকিজ যাদের মেয়াদ শেষ হওয়ার তারিখ-সময় অতীতে আছে তারা এই ফিল্টারের মানদণ্ড পূরণ করে না। কুকির জীবনকাল হয় 'সর্বোচ্চ বয়স' বা 'মেয়াদ শেষ' কুকি বৈশিষ্ট্য থেকে গণনা করা হয়। উভয়ই নির্দিষ্ট করা থাকলে, কুকির জীবনকাল গণনা করতে 'সর্বোচ্চ বয়স' ব্যবহার করা হয়।
- ডোমেইন
স্ট্রিং ঐচ্ছিক
ডোমেন কুকি বৈশিষ্ট্যের মান।
- মেয়াদ শেষ
স্ট্রিং ঐচ্ছিক
মেয়াদ শেষ হওয়া কুকি বৈশিষ্ট্যের মান।
- শুধুমাত্র http
স্ট্রিং ঐচ্ছিক
HttpOnly কুকি অ্যাট্রিবিউটের অস্তিত্ব।
- সর্বোচ্চ বয়স
সংখ্যা ঐচ্ছিক
সর্বোচ্চ বয়সের কুকি বৈশিষ্ট্যের মান
- নাম
স্ট্রিং ঐচ্ছিক
একটি কুকির নাম।
- পথ
স্ট্রিং ঐচ্ছিক
পাথ কুকি বৈশিষ্ট্যের মান।
- নিরাপদ
স্ট্রিং ঐচ্ছিক
সিকিউর কুকি অ্যাট্রিবিউটের অস্তিত্ব।
- সেশন কুকি
বুলিয়ান ঐচ্ছিক
ফিল্টার সেশন কুকিজ. সেশন কুকির 'সর্বোচ্চ-বয়স' বা 'মেয়াদ শেষ' অ্যাট্রিবিউটের মধ্যে কোনো জীবনকাল নির্দিষ্ট করা নেই।
- মান
স্ট্রিং ঐচ্ছিক
একটি কুকির মান, ডাবল-উদ্ধৃতিতে প্যাড করা যেতে পারে।
HeaderFilter
বিভিন্ন মানদণ্ডের জন্য ফিল্টার অনুরোধ শিরোনাম। একাধিক মানদণ্ড একটি সংযোজন হিসাবে মূল্যায়ন করা হয়।
বৈশিষ্ট্য
- নাম রয়েছে
স্ট্রিং | স্ট্রিং[] ঐচ্ছিক
শিরোনামের নামটিতে নির্দিষ্ট করা সমস্ত স্ট্রিং থাকলে মেলে।
- নাম সমান
স্ট্রিং ঐচ্ছিক
হেডারের নাম নির্দিষ্ট স্ট্রিংয়ের সমান হলে মেলে।
- নাম উপসর্গ
স্ট্রিং ঐচ্ছিক
হেডারের নাম নির্দিষ্ট স্ট্রিং দিয়ে শুরু হলে মেলে।
- nameSuffix
স্ট্রিং ঐচ্ছিক
হেডারের নাম নির্দিষ্ট স্ট্রিং দিয়ে শেষ হলে মেলে।
- মান ধারণ করে
স্ট্রিং | স্ট্রিং[] ঐচ্ছিক
শিরোনাম মান নির্দিষ্ট স্ট্রিং সব ধারণ করে যদি মেলে.
- মান সমান
স্ট্রিং ঐচ্ছিক
হেডার মান নির্দিষ্ট স্ট্রিং এর সমান হলে মেলে।
- মান উপসর্গ
স্ট্রিং ঐচ্ছিক
হেডার মান নির্দিষ্ট স্ট্রিং দিয়ে শুরু হলে মেলে।
- valueSuffix
স্ট্রিং ঐচ্ছিক
হেডার মান নির্দিষ্ট স্ট্রিং দিয়ে শেষ হলে মেলে।
IgnoreRules
নির্দিষ্ট মানদণ্ডের সাথে মেলে এমন সমস্ত নিয়ম মাস্ক করে।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: IgnoreRules) => {...}
- রিটার্ন
- hasTag
স্ট্রিং ঐচ্ছিক
সেট করা হলে, নির্দিষ্ট ট্যাগ সহ নিয়ম উপেক্ষা করা হয়। এই উপেক্ষা অব্যাহত থাকে না, এটি শুধুমাত্র একই নেটওয়ার্ক অনুরোধ পর্যায়ের নিয়ম এবং তাদের ক্রিয়াগুলিকে প্রভাবিত করে৷ নোট করুন যে নিয়মগুলি তাদের অগ্রাধিকারের ক্রমানুসারে কার্যকর করা হয়। এই ক্রিয়াটি বর্তমান নিয়মের চেয়ে কম অগ্রাধিকারের নিয়মগুলিকে প্রভাবিত করে৷ একই অগ্রাধিকার সহ নিয়মগুলি উপেক্ষা করা যেতে পারে বা নাও হতে পারে৷
- কম অগ্রাধিকার
সংখ্যা ঐচ্ছিক
সেট করা হলে, নির্দিষ্ট মানের চেয়ে কম অগ্রাধিকার সহ নিয়ম উপেক্ষা করা হয়। এই সীমানা স্থায়ী হয় না, এটি একই নেটওয়ার্ক অনুরোধ পর্যায়ে শুধুমাত্র নিয়ম এবং তাদের ক্রিয়াগুলিকে প্রভাবিত করে।
RedirectByRegEx
URL এ একটি নিয়মিত অভিব্যক্তি প্রয়োগ করে একটি অনুরোধ পুনঃনির্দেশ করে। রেগুলার এক্সপ্রেশন RE2 সিনট্যাক্স ব্যবহার করে।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: RedirectByRegEx) => {...}
- arg
- রিটার্ন
- থেকে
স্ট্রিং
একটি ম্যাচ প্যাটার্ন যাতে ক্যাপচার গ্রুপ থাকতে পারে। ক্যাপচার গ্রুপগুলিকে জাভাস্ক্রিপ্ট রেগুলার এক্সপ্রেশনের কাছাকাছি হওয়ার জন্য RE2 সিনট্যাক্স (\1, \2, ...) এর পরিবর্তে পার্ল সিনট্যাক্সে ($1, $2, ...) উল্লেখ করা হয়েছে।
- থেকে
স্ট্রিং
গন্তব্য প্যাটার্ন।
RedirectRequest
ঘোষণামূলক ইভেন্ট অ্যাকশন যা একটি নেটওয়ার্ক অনুরোধ পুনঃনির্দেশ করে।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: RedirectRequest) => {...}
- রিটার্ন
- redirectUrl
স্ট্রিং
গন্তব্য যেখানে অনুরোধ পুনঃনির্দেশিত হয়.
RedirectToEmptyDocument
ঘোষণামূলক ইভেন্ট অ্যাকশন যা একটি খালি নথিতে একটি নেটওয়ার্ক অনুরোধ পুনঃনির্দেশ করে।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: RedirectToEmptyDocument) => {...}
- রিটার্ন
RedirectToTransparentImage
ঘোষণামূলক ইভেন্ট অ্যাকশন যা একটি নেটওয়ার্ক অনুরোধকে একটি স্বচ্ছ ছবিতে পুনঃনির্দেশ করে।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: RedirectToTransparentImage) => {...}
RemoveRequestCookie
অনুরোধের এক বা একাধিক কুকি মুছে দেয়। মনে রাখবেন যে এটি কুকিজ API ব্যবহার করতে পছন্দ করে কারণ এটি গণনাগতভাবে কম ব্যয়বহুল।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: RemoveRequestCookie) => {...}
- রিটার্ন
- ফিল্টার
কুকির জন্য ফিল্টার যা সরানো হবে। সমস্ত খালি এন্ট্রি উপেক্ষা করা হয়.
RemoveRequestHeader
নির্দিষ্ট নামের অনুরোধ শিরোনাম সরান. একই অনুরোধে একই হেডার নামের সাথে SetRequestHeader এবং RemoveRequestHeader ব্যবহার করবেন না। প্রতিটি অনুরোধ শিরোনামের নাম প্রতিটি অনুরোধে শুধুমাত্র একবার ঘটে।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: RemoveRequestHeader) => {...}
- রিটার্ন
- নাম
স্ট্রিং
HTTP অনুরোধ শিরোনামের নাম (কেস-সংবেদনশীল)।
RemoveResponseCookie
প্রতিক্রিয়ার এক বা একাধিক কুকি মুছে দেয়। মনে রাখবেন যে এটি কুকিজ API ব্যবহার করতে পছন্দ করে কারণ এটি গণনাগতভাবে কম ব্যয়বহুল।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: RemoveResponseCookie) => {...}
- রিটার্ন
- ফিল্টার
কুকির জন্য ফিল্টার যা সরানো হবে। সমস্ত খালি এন্ট্রি উপেক্ষা করা হয়.
RemoveResponseHeader
নির্দিষ্ট নাম এবং মানগুলির সমস্ত প্রতিক্রিয়া শিরোনাম মুছে দেয়।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: RemoveResponseHeader) => {...}
- রিটার্ন
- নাম
স্ট্রিং
HTTP অনুরোধ শিরোনামের নাম (কেস-সংবেদনশীল)।
- মান
স্ট্রিং ঐচ্ছিক
HTTP অনুরোধ হেডার মান (কেস-সংবেদনশীল)।
RequestCookie
HTTP অনুরোধে একটি কুকির ফিল্টার বা স্পেসিফিকেশন।
বৈশিষ্ট্য
- নাম
স্ট্রিং ঐচ্ছিক
একটি কুকির নাম।
- মান
স্ট্রিং ঐচ্ছিক
একটি কুকির মান, ডাবল-উদ্ধৃতিতে প্যাড করা যেতে পারে।
RequestMatcher
বিভিন্ন মানদণ্ড দ্বারা নেটওয়ার্ক ইভেন্ট মেলে।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: RequestMatcher) => {...}
- arg
- রিটার্ন
- বিষয়বস্তুর প্রকার
স্ট্রিং[] ঐচ্ছিক
একটি প্রতিক্রিয়ার MIME মিডিয়া টাইপ (HTTP বিষয়বস্তু-প্রকার শিরোনাম থেকে) তালিকায় থাকলে মেলে।
- ContentType বাদ দিন
স্ট্রিং[] ঐচ্ছিক
একটি প্রতিক্রিয়ার MIME মিডিয়া প্রকার (HTTP সামগ্রী-প্রকার শিরোনাম থেকে) তালিকায় না থাকলে মেলে।
- Request Headers exclude
হেডার ফিল্টার [] ঐচ্ছিক
অনুরোধ শিরোনামগুলির কোনোটিই হেডারফিল্টারের সাথে মেলে না।
- রেসপন্স হেডার বাদ দিন
হেডার ফিল্টার [] ঐচ্ছিক
প্রতিক্রিয়া শিরোনামগুলির কোনোটিই হেডারফিল্টারের সাথে মেলে না।
- FirstPartyForCookiesUrl
UrlFilter ঐচ্ছিক
অবচয়মুক্তির পর থেকে উপেক্ষিত 82.
অনুরোধের 'প্রথম পক্ষ' URL-এর জন্য UrlFilter-এর শর্ত পূরণ করা হলে মেলে। একটি অনুরোধের 'প্রথম পক্ষ' URL, যখন উপস্থিত থাকে, তখন অনুরোধের লক্ষ্য URL থেকে আলাদা হতে পারে এবং কুকিগুলির জন্য তৃতীয় পক্ষের চেকের জন্য 'প্রথম পক্ষ' হিসাবে বিবেচিত হয় তা বর্ণনা করে৷
- অনুরোধ শিরোনাম
হেডার ফিল্টার [] ঐচ্ছিক
মেলে যদি কিছু অনুরোধ হেডার হেডারফিল্টারগুলির একটির সাথে মিলে যায়।
- রিসোর্স টাইপ
রিসোর্স টাইপ [] ঐচ্ছিক
একটি অনুরোধের ধরন তালিকায় থাকা থাকলে মেলে। কোনো প্রকারের সাথে মেলে না এমন অনুরোধ ফিল্টার আউট করা হবে।
- প্রতিক্রিয়া শিরোনাম
হেডার ফিল্টার [] ঐচ্ছিক
কিছু প্রতিক্রিয়া শিরোনাম হেডার ফিল্টারগুলির একটির সাথে মিলে গেলে মেলে।
- পর্যায়গুলি
পর্যায় [] ঐচ্ছিক
ধাপগুলি বর্ণনা করে স্ট্রিংগুলির একটি তালিকা রয়েছে৷ অনুমোদিত মান হল 'onBeforeRequest', 'onBeforeSendHeaders', 'onHeadersReceived', 'onAuthRequired'। যদি এই বৈশিষ্ট্যটি উপস্থিত থাকে, তাহলে এটি তালিকাভুক্তদের জন্য প্রযোজ্য পর্যায়ে সীমাবদ্ধ করে। মনে রাখবেন যে পুরো শর্তটি শুধুমাত্র সমস্ত বৈশিষ্ট্যের সাথে সামঞ্জস্যপূর্ণ পর্যায়ে প্রযোজ্য।
- থার্ডপার্টি ফরকুকিজ
বুলিয়ান ঐচ্ছিক
অবচয়87 মুক্তির পর থেকে উপেক্ষা করা হয়েছে।
যদি সত্যে সেট করা হয়, তৃতীয় পক্ষের কুকি নীতির সাপেক্ষে অনুরোধের সাথে মেলে। মিথ্যাতে সেট করা হলে, অন্য সব অনুরোধের সাথে মেলে।
- url
UrlFilter ঐচ্ছিক
অনুরোধের URL-এর জন্য UrlFilter-এর শর্ত পূরণ হলে মেলে।
ResponseCookie
HTTP প্রতিক্রিয়াগুলিতে একটি কুকির একটি স্পেসিফিকেশন।
বৈশিষ্ট্য
- ডোমেইন
স্ট্রিং ঐচ্ছিক
ডোমেন কুকি বৈশিষ্ট্যের মান।
- মেয়াদ শেষ
স্ট্রিং ঐচ্ছিক
মেয়াদ শেষ হওয়া কুকি বৈশিষ্ট্যের মান।
- শুধুমাত্র http
স্ট্রিং ঐচ্ছিক
HttpOnly কুকি অ্যাট্রিবিউটের অস্তিত্ব।
- সর্বোচ্চ বয়স
সংখ্যা ঐচ্ছিক
সর্বোচ্চ বয়সের কুকি বৈশিষ্ট্যের মান
- নাম
স্ট্রিং ঐচ্ছিক
একটি কুকির নাম।
- পথ
স্ট্রিং ঐচ্ছিক
পাথ কুকি বৈশিষ্ট্যের মান।
- নিরাপদ
স্ট্রিং ঐচ্ছিক
সিকিউর কুকি অ্যাট্রিবিউটের অস্তিত্ব।
- মান
স্ট্রিং ঐচ্ছিক
একটি কুকির মান, ডাবল-উদ্ধৃতিতে প্যাড করা যেতে পারে।
SendMessageToExtension
declarativeWebRequest.onMessage
ইভেন্টটিকে ট্রিগার করে।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: SendMessageToExtension) => {...}
- রিটার্ন
- বার্তা
স্ট্রিং
ডিকশনারির
message
অ্যাট্রিবিউটে যে মানটি পাস করা হবে তা ইভেন্ট হ্যান্ডলারে পাস করা হবে।
SetRequestHeader
নির্দিষ্ট নামের অনুরোধ শিরোনাম নির্দিষ্ট মান সেট করে। যদি নির্দিষ্ট নামের সাথে একটি শিরোনাম আগে বিদ্যমান না থাকে তবে একটি নতুন তৈরি করা হয়। হেডার নামের তুলনা সবসময় কেস-সংবেদনশীল। প্রতিটি অনুরোধ শিরোনামের নাম প্রতিটি অনুরোধে শুধুমাত্র একবার ঘটে।
বৈশিষ্ট্য
- নির্মাণকারী
অকার্যকর
constructor
ফাংশনটি এর মত দেখাচ্ছে:(arg: SetRequestHeader) => {...}
- রিটার্ন
- নাম
স্ট্রিং
HTTP অনুরোধ শিরোনাম নাম.
- মান
স্ট্রিং
HTTP অনুরোধ শিরোনাম মান.
Stage
এনাম
"অনবিফোর রিকোয়েস্ট" "onBeforeSendHeaders" "অনহেডার প্রাপ্ত" "অনঅথরিকোয়ার্ড"
ঘটনা
onMessage
chrome.declarativeWebRequest.onMessage.addListener(
callback: function,
)
ঘোষণামূলক ওয়েব অনুরোধ API-এর একটি অ্যাকশন থেকে declarativeWebRequest.SendMessageToExtension
এর মাধ্যমে একটি বার্তা পাঠানো হলে বহিস্কার করা হয়।
পরামিতি
- কলব্যাক
ফাংশন
callback
প্যারামিটারটি এর মতো দেখাচ্ছে:(details: object) => void
- বিস্তারিত
বস্তু
- ডকুমেন্ট আইডি
স্ট্রিং ঐচ্ছিক
নথির একটি UUID যা অনুরোধ করেছে।
- নথি জীবনচক্র
নথিটি যে জীবনচক্রে রয়েছে৷
- ফ্রেমআইডি
সংখ্যা
মান 0 নির্দেশ করে যে অনুরোধটি প্রধান ফ্রেমে ঘটে; একটি ইতিবাচক মান একটি সাবফ্রেমের ID নির্দেশ করে যেখানে অনুরোধটি ঘটে। যদি একটি (সাব-) ফ্রেমের নথি লোড করা হয় (
type
হলmain_frame
বাsub_frame
),frameId
এই ফ্রেমের আইডি নির্দেশ করে, বাইরের ফ্রেমের আইডি নয়। ফ্রেম আইডি একটি ট্যাবের মধ্যে অনন্য। - ফ্রেম টাইপ
যে ধরনের ফ্রেমে নেভিগেশন হয়েছে।
- বার্তা
স্ট্রিং
কলিং স্ক্রিপ্ট দ্বারা পাঠানো বার্তা.
- পদ্ধতি
স্ট্রিং
স্ট্যান্ডার্ড HTTP পদ্ধতি।
- parentDocumentId
স্ট্রিং ঐচ্ছিক
এই ফ্রেমের মালিক নথির একটি UUID। অভিভাবক না থাকলে এটি সেট করা হয় না।
- parentFrameId
সংখ্যা
ফ্রেমের আইডি যা অনুরোধ পাঠানো ফ্রেমটিকে মোড়ানো। কোন প্যারেন্ট ফ্রেম বিদ্যমান না থাকলে -1 এ সেট করুন।
- অনুরোধ আইডি
স্ট্রিং
অনুরোধের আইডি। একটি ব্রাউজার সেশনের মধ্যে অনুরোধ আইডি অনন্য। ফলস্বরূপ, তারা একই অনুরোধের বিভিন্ন ইভেন্টের সাথে সম্পর্কিত করতে ব্যবহার করা যেতে পারে।
- মঞ্চ
নেটওয়ার্ক অনুরোধের পর্যায় যেখানে ইভেন্টটি ট্রিগার করা হয়েছিল।
- ট্যাবআইডি
সংখ্যা
যে ট্যাবে অনুরোধ করা হয় তার আইডি। অনুরোধটি ট্যাবের সাথে সম্পর্কিত না হলে -1 এ সেট করুন।
- টাইমস্ট্যাম্প
সংখ্যা
যুগের পর থেকে মিলিসেকেন্ডে যখন এই সংকেতটি ট্রিগার হয়।
অনুরোধকৃত সম্পদ কিভাবে ব্যবহার করা হবে।
- url
স্ট্রিং
onRequest
addRules
, removeRules
এবং getRules
সমন্বিত ঘোষণামূলক ইভেন্ট API প্রদান করে।