chrome.declarativeContent

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

বর্ণনা

অনুমতি

ব্যবহার

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

ব্যবহারকারী এক্সটেনশনের অ্যাকশনে ক্লিক করার পর কোনো পেজের সাথে ইন্টারঅ্যাক্ট করতে activeTab পারমিশনটি ব্যবহার করুন।

নিয়ম

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

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

let rule1 = {
  conditions: [
    new chrome.declarativeContent.PageStateMatcher({
      pageUrl: { hostSuffix: '.google.com', schemes: ['https'] },
      css: ["input[type='password']"]
    })
  ],
  actions: [ new chrome.declarativeContent.ShowAction() ]
};

ভিডিও সহ গুগল সাইটগুলির জন্যও এক্সটেনশনটির অ্যাকশন সক্রিয় করতে, আপনি একটি দ্বিতীয় শর্ত যোগ করতে পারেন, কারণ প্রতিটি শর্তই সমস্ত নির্দিষ্ট অ্যাকশন ট্রিগার করার জন্য যথেষ্ট:

let rule2 = {
  conditions: [
    new chrome.declarativeContent.PageStateMatcher({
      pageUrl: { hostSuffix: '.google.com', schemes: ['https'] },
      css: ["input[type='password']"]
    }),
    new chrome.declarativeContent.PageStateMatcher({
      css: ["video"]
    })
  ],
  actions: [ new chrome.declarativeContent.ShowAction() ]
};

onPageChanged ইভেন্টটি পরীক্ষা করে দেখে যে কোনো নিয়মের অন্তত একটি শর্ত পূরণ হয়েছে কিনা এবং সেই অনুযায়ী অ্যাকশনগুলো সম্পাদন করে। নিয়মগুলো ব্রাউজিং সেশন জুড়ে স্থায়ী থাকে; তাই, এক্সটেনশন ইনস্টল করার সময় আপনার প্রথমে removeRules ব্যবহার করে পূর্বে ইনস্টল করা নিয়মগুলো মুছে ফেলা উচিত এবং তারপরে addRules ব্যবহার করে নতুন নিয়মগুলো রেজিস্টার করা উচিত।

chrome.runtime.onInstalled.addListener(function(details) {
  chrome.declarativeContent.onPageChanged.removeRules(undefined, function() {
    chrome.declarativeContent.onPageChanged.addRules([rule2]);
  });
});

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

পৃষ্ঠার URL মেলানো

URL-এর শর্তগুলো পূরণ হলে PageStateMatcher.pageurl মিলে যায়। সবচেয়ে সাধারণ শর্তগুলো হলো host, path, বা url-এর যেকোনো একটির সংযুক্তি, যার পরে Contains, Equals, Prefix, বা Suffix থাকে। নিচের সারণিতে কয়েকটি উদাহরণ দেওয়া হলো:

সমস্ত শর্তই কেস-সেনসিটিভ। শর্তাবলির সম্পূর্ণ তালিকার জন্য, UrlFilter দেখুন।

সিএসএস মিলানো

PageStateMatcher.css শর্তগুলো অবশ্যই যৌগিক সিলেক্টর হতে হবে, অর্থাৎ আপনি আপনার সিলেক্টরের মধ্যে স্পেস বা " > " এর মতো কম্বিনেটর অন্তর্ভুক্ত করতে পারবেন না। এটি ক্রোমকে আরও দক্ষতার সাথে সিলেক্টরগুলো মেলাতে সাহায্য করে।

CSS কন্ডিশন শুধুমাত্র প্রদর্শিত এলিমেন্টগুলোর সাথেই মেলে: যদি আপনার সিলেক্টরের সাথে মেলে এমন কোনো এলিমেন্ট বা তার কোনো প্যারেন্ট এলিমেন্টের display:none display:none , তাহলে কন্ডিশনটি মেলে না। visibility:hidden দিয়ে স্টাইল করা, স্ক্রিনের বাইরে পজিশন করা, বা অন্য এলিমেন্ট দ্বারা লুকানো এলিমেন্টগুলোও আপনার কন্ডিশন মেলাতে পারে।

বুকমার্ক করা রাজ্য মেলানো

PageStateMatcher.isBookmarked কন্ডিশনটি ব্যবহারকারীর প্রোফাইলে থাকা বর্তমান URL-টির বুকমার্ক করা অবস্থা মেলানোর সুযোগ দেয়। এই কন্ডিশনটি ব্যবহার করার জন্য এক্সটেনশন ম্যানিফেস্টে অবশ্যই "bookmarks" পারমিশনটি ঘোষণা করতে হবে।