chrome.events

রিফ্রেশ তারিখ: ২০২৬-০৯-২৫ রোবটস: নোইনডেক্স

বর্ণনা

Event হলো এমন একটি অবজেক্ট যা কোনো গুরুত্বপূর্ণ ঘটনা ঘটলে আপনাকে অবহিত করে। অ্যালার্মের সময় শেষ হলে বিজ্ঞপ্তি পাওয়ার জন্য chrome.alarms.onAlarm ইভেন্টটি ব্যবহারের একটি উদাহরণ নিচে দেওয়া হলো:

chrome.alarms.onAlarm.addListener(function(alarm) {
  appendToLog('alarms.onAlarm --'
              + ' name: '          + alarm.name
              + ' scheduledTime: ' + alarm.scheduledTime);
});

উদাহরণে যেমন দেখানো হয়েছে, আপনি addListener() ব্যবহার করে নোটিফিকেশনের জন্য রেজিস্টার করেন। addListener() এর আর্গুমেন্টটি সর্বদা একটি ফাংশন যা আপনি ইভেন্টটি হ্যান্ডেল করার জন্য সংজ্ঞায়িত করেন, কিন্তু ফাংশনের প্যারামিটারগুলো নির্ভর করে আপনি কোন ইভেন্টটি হ্যান্ডেল করছেন তার উপর। alarms.onAlarm এর ডকুমেন্টেশন দেখলে আপনি দেখতে পাবেন যে ফাংশনটির একটিমাত্র প্যারামিটার রয়েছে: একটি alarms.Alarm অবজেক্ট, যাতে অতিবাহিত অ্যালার্মের বিবরণ থাকে।

ইভেন্ট ব্যবহার করে এমন কিছু উদাহরণ এপিআই হলো: alarms , i18n , identity , runtime । বেশিরভাগ ক্রোম এপিআই-ই এটি ব্যবহার করে।

ঘোষণামূলক ইভেন্ট হ্যান্ডলার

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

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

নিয়ম

সবচেয়ে সরল নিয়মটি এক বা একাধিক শর্ত এবং এক বা একাধিক ক্রিয়া নিয়ে গঠিত:

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

শর্তগুলোর কোনো একটি পূরণ হলে, সমস্ত কার্যক্রম সম্পাদিত হয়।

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

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

ইভেন্ট অবজেক্ট

ইভেন্ট অবজেক্টগুলো রুল সমর্থন করতে পারে। এই ইভেন্ট অবজেক্টগুলো কোনো ইভেন্ট ঘটলে কলব্যাক ফাংশন কল করে না, বরং কোনো নিবন্ধিত রুলে অন্তত একটি শর্ত পূরণ হয়েছে কিনা তা পরীক্ষা করে এবং সেই রুলের সাথে যুক্ত অ্যাকশনগুলো সম্পাদন করে। ডিক্লারেটিভ এপিআই সমর্থনকারী ইভেন্ট অবজেক্টগুলোর তিনটি প্রাসঙ্গিক মেথড রয়েছে: events.Event.addRules , events.Event.removeRules , এবং events.Event.getRules ।

নিয়ম যোগ করা

নিয়ম যোগ করতে ইভেন্ট অবজেক্টের addRules() ফাংশনটি কল করুন। এটি প্রথম প্যারামিটার হিসেবে নিয়ম ইনস্ট্যান্সগুলোর একটি অ্যারে এবং কাজ সম্পন্ন হলে কল হওয়ার জন্য একটি কলব্যাক ফাংশন গ্রহণ করে।

var rule_list = [rule1, rule2, ...];
function addRules(rule_list, function callback(details) {...});

যদি নিয়মগুলো সফলভাবে যোগ করা হয়, তাহলে details প্যারামিটারটিতে যোগ করা নিয়মগুলোর একটি অ্যারে থাকে, যা প্রদত্ত rule_list মতোই একই ক্রমে প্রদর্শিত হয়, যেখানে ঐচ্ছিক প্যারামিটার id এবং priority জেনারেট করা মান দিয়ে পূরণ করা হয়। যদি কোনো নিয়ম অবৈধ হয়, যেমন—কারণ এতে একটি অবৈধ শর্ত বা অ্যাকশন রয়েছে, তাহলে কোনো নিয়মই যোগ করা হয় না এবং কলব্যাক ফাংশনটি কল করার সময় 'runtime.lastError' ভেরিয়েবলটি সেট করা হয়। rule_list এর প্রতিটি নিয়মে অবশ্যই একটি অনন্য আইডেন্টিফায়ার থাকতে হবে যা বর্তমানে অন্য কোনো নিয়ম দ্বারা ব্যবহৃত হচ্ছে না, অথবা একটি খালি আইডেন্টিফায়ার থাকতে হবে।

নিয়ম অপসারণ

নিয়মগুলো অপসারণ করতে removeRules() ফাংশনটি কল করুন। এটি প্রথম প্যারামিটার হিসেবে নিয়ম শনাক্তকারীগুলোর একটি ঐচ্ছিক অ্যারে এবং দ্বিতীয় প্যারামিটার হিসেবে একটি কলব্যাক ফাংশন গ্রহণ করে।

var rule_ids = ["id1", "id2", ...];
function removeRules(rule_ids, function callback() {...});

যদি rule_ids আইডেন্টিফায়ারের একটি অ্যারে হয়, তবে অ্যারেতে তালিকাভুক্ত আইডেন্টিফায়ার আছে এমন সমস্ত নিয়ম মুছে ফেলা হয়। যদি rule_ids এ কোনো অজানা আইডেন্টিফায়ার থাকে, তবে সেই আইডেন্টিফায়ারটি নীরবে উপেক্ষা করা হয়। যদি rule_ids undefined হয়, তবে এই এক্সটেনশনের সমস্ত নিবন্ধিত নিয়ম মুছে ফেলা হয়। নিয়মগুলো মুছে ফেলার পর callback() ফাংশনটি কল করা হয়।

নিয়ম পুনরুদ্ধার করা

বর্তমানে নিবন্ধিত নিয়মগুলির একটি তালিকা পেতে, getRules() ফাংশনটি কল করুন। এটি removeRules এর মতো একই অর্থবোধক নিয়ম শনাক্তকারীগুলির একটি ঐচ্ছিক অ্যারে এবং একটি কলব্যাক ফাংশন গ্রহণ করে।

var rule_ids = ["id1", "id2", ...];
function getRules(rule_ids, function callback(details) {...});

callback() ফাংশনে পাঠানো details প্যারামিটারটি নিয়মগুলির একটি অ্যারে নির্দেশ করে, যার মধ্যে পূরণ করা ঐচ্ছিক প্যারামিটারগুলিও অন্তর্ভুক্ত থাকে।

কর্মক্ষমতা

সর্বোচ্চ কর্মক্ষমতা অর্জনের জন্য, আপনার নিম্নলিখিত নির্দেশিকাগুলো মনে রাখা উচিত।

একসাথে অনেকগুলো নিয়ম নিবন্ধন এবং নিবন্ধনমুক্ত করা হয়। প্রতিটি নিবন্ধন বা নিবন্ধনমুক্তকরণের পর, ক্রোমকে তার অভ্যন্তরীণ ডেটা কাঠামো হালনাগাদ করতে হয়। এই হালনাগাদ একটি ব্যয়বহুল প্রক্রিয়া।

পরিবর্তে:

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

পছন্দ করুন:

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

events.UrlFilter- এ রেগুলার এক্সপ্রেশনের পরিবর্তে সাবস্ট্রিং ম্যাচিং ব্যবহার করুন। সাবস্ট্রিং-ভিত্তিক ম্যাচিং অত্যন্ত দ্রুত।

পরিবর্তে:

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

পছন্দ করুন:

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

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

পরিবর্তে:

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

পছন্দ করুন:

  var rule = { conditions: [condition1, condition2],
                actions: [new chrome.declarativeWebRequest.CancelRequest()]};
  chrome.declarativeWebRequest.onRequest.addRules([rule]);

ফিল্টার করা ইভেন্টগুলি

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

ফিল্টার করা ইভেন্টগুলোর উদ্দেশ্য হলো এই ধরনের ম্যানুয়াল ফিল্টারিং কোড থেকে উত্তরণের সুযোগ করে দেওয়া:

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

এর মধ্যে:

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

ইভেন্টগুলো নির্দিষ্ট ফিল্টার সমর্থন করে যা সেই ইভেন্টের জন্য অর্থবহ। একটি ইভেন্ট যে ফিল্টারগুলো সমর্থন করে তার তালিকা সেই ইভেন্টের ডকুমেন্টেশনের "ফিল্টার" বিভাগে উল্লেখ করা থাকবে।

URL মেলানোর ক্ষেত্রে (যেমন উপরের উদাহরণে), ইভেন্ট ফিল্টারগুলো স্কিম এবং পোর্ট মেলানো ছাড়া, events.UrlFilter এর মাধ্যমে প্রকাশযোগ্য একই URL মেলানোর ক্ষমতা সমর্থন করে।