chrome.permissions

الوصف

المفاهيم والاستخدام

توجد تحذيرات بشأن الأذونات لوصف الإمكانات التي تمنحها واجهة برمجة التطبيقات، ولكن قد لا تكون بعض هذه التحذيرات واضحة. تسمح واجهة Permissions API للمطوّرين بشرح التحذيرات المتعلّقة بالأذونات وتقديم ميزات جديدة تدريجيًا لتوفير مقدّمة خالية من المخاطر للمستخدمين. بهذه الطريقة، يمكن للمستخدمين تحديد مقدار الوصول الذي يريدون منحه والميزات التي يريدون تفعيلها.

على سبيل المثال، تتجاهل الوظيفة الأساسية لإضافة الأذونات الاختيارية صفحة علامة التبويب الجديدة. هناك ميزة واحدة تعرض هدف المستخدم لليوم. لا تتطلّب هذه الميزة سوى إذن التخزين، الذي لا يتضمّن تحذيرًا. تحتوي الإضافة على ميزة إضافية يمكن للمستخدمين تفعيلها بالنقر على الزر التالي:

يتطلب عرض أهم المواقع الإلكترونية للمستخدم إذن topSites الذي يتضمّن التحذير التالي.

تنفيذ الأذونات الاختيارية

الخطوة 1: تحديد الأذونات المطلوبة والأذونات الاختيارية

يمكن للإضافة تقديم بيان عن الأذونات المطلوبة والاختيارية. بوجه عام، عليك تنفيذ ما يلي:

• استخدِم الأذونات المطلوبة عندما تكون مطلوبة للوظائف الأساسية للإضافة.
• يمكنك استخدام الأذونات الاختيارية عند الحاجة إليها مع الميزات الاختيارية في إضافتك.

مزايا الأذونات المطلوبة:

• عدد أقل من الطلبات: يمكن للإضافة أن تطلب من المستخدم مرة واحدة قبول جميع الأذونات.
• تطوير أكثر بساطة: نضمن لك توفُّر الأذونات المطلوبة.

مزايا الأذونات الاختيارية:

• أمان أفضل: يتم تشغيل الإضافات بأذونات أقل لأنّ المستخدمين يفعّلون الأذونات فقط. المطلوبة.
• معلومات أفضل للمستخدمين: يمكن للإضافة توضيح سبب احتياجها إلى إذن معيّن. عندما يفعّل المستخدِم الميزة ذات الصلة.
• الترقيات الأسهل: عند ترقية الإضافة، لن يوقفها Chrome للمستخدمين في حال تضيف الترقية الأذونات الاختيارية بدلاً من الأذونات المطلوبة.

الخطوة 2: تعريف الأذونات الاختيارية في البيان

يُرجى تعريف الأذونات الاختيارية في بيان الإضافة باستخدام المفتاح optional_permissions. باستخدام التنسيق نفسه المستخدَم في حقل الأذونات:

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

إذا أردت طلب الأجهزة المضيفة التي تكتشفها فقط في وقت التشغيل، عليك تضمين "https://*/*" في الحقل optional_host_permissions الخاص بالإضافة. يتيح لك ذلك تحديد أي مصدر في "Permissions.origins" ما دام يشتمل على قيمة مطابقة. .

الأذونات التي لا يمكن تحديدها على أنّها اختيارية

يمكن تحديد معظم أذونات إضافات Chrome كخيار، مع الاستثناءات التالية.

راجِع الإفصاح عن الأذونات للحصول على مزيد من المعلومات عن الأذونات المتاحة وتحذيراتهم.

الخطوة 3: طلب أذونات اختيارية

اطلب الأذونات من داخل إيماءة المستخدم باستخدام 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 المستخدم بما إذا كانت إضافة الأذونات تؤدي إلى رسائل تحذير مختلفة عن التي شاهدها المستخدم بالفعل وقبلها. على سبيل المثال، قد ينتج عن الكود السابق مطالبة مثل التالي:

الخطوة 4: التحقّق من الأذونات الحالية للإضافة

للتحقّق ممّا إذا كانت الإضافة تمتلك إذنًا محدّدًا أو مجموعة من الأذونات، استخدِم 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.
  }
});

الخطوة 5: إزالة الأذونات

يجب إزالة الأذونات عند الاستغناء عنها. بعد إزالة إذن، يؤدي الاتصال بالرقم 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,
)

chrome.permissions.getAll(
  callback?: function,
)

chrome.permissions.remove(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.request(
  permissions: Permissions,
  callback?: function,
)

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

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