chrome.permissions

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

বর্ণনা

সংক্ষিপ্ত বিবরণ

একটি এপিআই (API) দ্বারা প্রদত্ত ক্ষমতাগুলো বর্ণনা করার জন্য পারমিশন ওয়ার্নিং (Permission warnings) থাকে, কিন্তু এই ওয়ার্নিংগুলোর মধ্যে কিছু কিছু সহজে বোঝা যায় না। পারমিশন এপিআই (Permissions API) ডেভেলপারদের পারমিশন ওয়ার্নিংগুলো ব্যাখ্যা করতে এবং ধীরে ধীরে নতুন ফিচার চালু করতে সাহায্য করে, যা ব্যবহারকারীদের এক্সটেনশনটির সাথে একটি ঝুঁকিমুক্ত পরিচিতি দেয়। এইভাবে, ব্যবহারকারীরা নির্দিষ্ট করে দিতে পারেন যে তারা কতটা অ্যাক্সেস দিতে ইচ্ছুক এবং কোন ফিচারগুলো তারা চালু করতে চান।

উদাহরণস্বরূপ, ঐচ্ছিক পারমিশন এক্সটেনশনটির মূল কার্যকারিতা হলো নতুন ট্যাব পৃষ্ঠাটিকে ওভাররাইড করা। এর একটি বৈশিষ্ট্য হলো ব্যবহারকারীর দিনের লক্ষ্য প্রদর্শন করা। এই বৈশিষ্ট্যটির জন্য শুধুমাত্র স্টোরেজ পারমিশন প্রয়োজন, যাতে কোনো সতর্কবার্তা অন্তর্ভুক্ত থাকে না। এক্সটেনশনটিতে একটি অতিরিক্ত বৈশিষ্ট্য রয়েছে, যা ব্যবহারকারীরা নিম্নলিখিত বোতামটিতে ক্লিক করে সক্রিয় করতে পারেন:

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

ঐচ্ছিক অনুমতি বাস্তবায়ন করা

ধাপ ১: কোন অনুমতিগুলো আবশ্যক এবং কোনগুলো ঐচ্ছিক তা নির্ধারণ করুন।

একটি এক্সটেনশন প্রয়োজনীয় এবং ঐচ্ছিক উভয় প্রকারের অনুমতি ঘোষণা করতে পারে। সাধারণভাবে, আপনার উচিত:

• আপনার এক্সটেনশনের মৌলিক কার্যকারিতার জন্য যখন প্রয়োজন, তখনই প্রয়োজনীয় অনুমতিগুলো ব্যবহার করুন।
• আপনার এক্সটেনশনের ঐচ্ছিক বৈশিষ্ট্যগুলির জন্য যখন প্রয়োজন হয়, তখনই ঐচ্ছিক অনুমতিগুলি ব্যবহার করুন।

প্রয়োজনীয় অনুমতির সুবিধাগুলো হলো:

• কমবার অনুরোধ: একটি এক্সটেনশন সমস্ত অনুমতি গ্রহণ করার জন্য ব্যবহারকারীকে একবার অনুরোধ করতে পারে।
• সহজতর উন্নয়ন: প্রয়োজনীয় অনুমতিগুলোর উপস্থিতি নিশ্চিত করা হয়।

ঐচ্ছিক অনুমতির সুবিধাসমূহ:

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

ধাপ ২: ম্যানিফেস্টে ঐচ্ছিক অনুমতিগুলো ঘোষণা করুন।

আপনার এক্সটেনশন ম্যানিফেস্টে ` optional_permissions কী ব্যবহার করে ঐচ্ছিক অনুমতিগুলো ঘোষণা করুন এবং এর জন্য `permissions` ফিল্ডের মতো একই ফরম্যাট ব্যবহার করুন:

{
  "name": "My extension",
  ...
  "optional_permissions": ["tabs"],
  "optional_host_permissions": ["https://www.google.com/"],
  ...
}

আপনি যদি এমন হোস্টের জন্য অনুরোধ করতে চান যা শুধুমাত্র রানটাইমে আবিষ্কৃত হয়, তাহলে আপনার এক্সটেনশনের optional_host_permissions ফিল্ডে "https://*/*" অন্তর্ভুক্ত করুন। এটি আপনাকে Permissions.origins- এ যেকোনো অরিজিন নির্দিষ্ট করার সুযোগ দেয়, যতক্ষণ পর্যন্ত সেটির স্কিম মিলে যায়।

যে অনুমতিগুলো ঐচ্ছিক হিসেবে নির্দিষ্ট করা যায় না

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

উপলব্ধ অনুমতি এবং সেগুলোর সতর্কতা সম্পর্কে আরও তথ্যের জন্য ‘অনুমতি ঘোষণা করুন’ এবং ‘ব্যবহারকারীদের সতর্ক করুন’ দেখুন।

ধাপ ৩: ঐচ্ছিক অনুমতির জন্য অনুরোধ করুন

ব্যবহারকারীর অঙ্গভঙ্গির ভেতর থেকে permissions.request() ব্যবহার করে অনুমতির জন্য অনুরোধ করুন:

document.querySelector('#my-button').addEventListener('click', (event) => {
  // Permissions must be requested from inside a user gesture, like a button's
  // click handler.
  chrome.permissions.request({
    permissions: ['tabs'],
    origins: ['https://www.google.com/']
  }, (granted) => {
    // The callback argument will be true if the user granted the permissions.
    if (granted) {
      doSomething();
    } else {
      doSomethingElse();
    }
  });
});

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

ধাপ ৪: এক্সটেনশনটির বর্তমান অনুমতিগুলো যাচাই করুন।

আপনার এক্সটেনশনের কোনো নির্দিষ্ট অনুমতি বা অনুমতিসমূহ আছে কিনা তা পরীক্ষা করতে, permission.contains() ব্যবহার করুন:

chrome.permissions.contains({
  permissions: ['tabs'],
  origins: ['https://www.google.com/']
}, (result) => {
  if (result) {
    // The extension has the permissions.
  } else {
    // The extension doesn't have the permissions.
  }
});

ধাপ ৫: অনুমতিগুলো মুছে ফেলুন

যখন আপনার আর প্রয়োজন হবে না, তখন অনুমতিগুলো মুছে ফেলা উচিত। কোনো অনুমতি মুছে ফেলার পর, permissions.request() কল করলে সাধারণত ব্যবহারকারীকে কোনো জিজ্ঞাসা না করেই অনুমতিটি আবার যুক্ত হয়ে যায়।

chrome.permissions.remove({
  permissions: ['tabs'],
  origins: ['https://www.google.com/']
}, (removed) => {
  if (removed) {
    // The permissions have been removed.
  } else {
    // The permissions have not been removed (e.g., you tried to remove
    // required permissions).
  }
});

chrome.permissions.contains(
  permissions: Permissions,
  callback?: function,
): Promise<boolean>

chrome.permissions.getAll(
  callback?: function,
): Promise<Permissions>

chrome.permissions.remove(
  permissions: Permissions,
  callback?: function,
): Promise<boolean>

chrome.permissions.request(
  permissions: Permissions,
  callback?: function,
): Promise<boolean>

chrome.permissions.onAdded.addListener(
  callback: function,
)

chrome.permissions.onRemoved.addListener(
  callback: function,
)