مجوزها را اعلام کنید

برای استفاده از اکثر APIها و ویژگی های برنامه افزودنی ، باید هدف برنامه افزودنی خود را در قسمت های مجوزهای مانیفست اعلام کنید. برنامه‌های افزودنی می‌توانند دسته‌های مجوزهای زیر را درخواست کنند که با استفاده از کلیدهای مانیفست مربوطه مشخص شده‌اند:

"permissions"
شامل مواردی از لیست رشته های شناخته شده است . تغییرات ممکن است باعث ایجاد یک هشدار شود.
"optional_permissions"
به جای زمان نصب توسط کاربر در زمان اجرا اعطا می شود.
"content_scripts.matches"
حاوی یک یا چند الگوی مطابقت است که به اسکریپت های محتوا اجازه می دهد به یک یا چند میزبان تزریق شود. تغییرات ممکن است باعث ایجاد یک هشدار شود.
"host_permissions"
شامل یک یا چند الگوی تطبیق است که به یک یا چند میزبان دسترسی دارد. تغییرات ممکن است باعث ایجاد یک هشدار شود.
"optional_host_permissions"
به جای زمان نصب توسط کاربر در زمان اجرا اعطا می شود.

اگر برنامه افزودنی شما توسط بدافزار به خطر بیفتد، مجوزها به محدود کردن آسیب کمک می کنند. برخی از هشدارهای مجوز برای رضایت کاربران قبل از نصب یا در زمان اجرا، همانطور که در مجوز با هشدارها توضیح داده شده است، نمایش داده می شود.

استفاده از مجوزهای اختیاری را در هر جایی که عملکرد برنامه افزودنی شما اجازه می دهد، در نظر بگیرید تا به کاربران کنترل آگاهانه ای بر دسترسی به منابع و داده ها ارائه دهید.

اگر یک API به مجوز نیاز داشته باشد، مستندات آن نحوه اعلام آن را توضیح می‌دهد. برای مثال، Storage API را ببینید.

آشکار

نمونه زیر نمونه ای از بخش مجوزهای یک فایل مانیفست است:

manifest.json:

{
  "name": "Permissions Extension",
  ...
  "permissions": [
    "activeTab",
    "contextMenus",
    "storage"
  ],
  "optional_permissions": [
    "topSites",
  ],
  "host_permissions": [
    "https://www.developer.chrome.com/*"
  ],
  "optional_host_permissions":[
    "https://*/*",
    "http://*/*"
  ],
  ...
  "manifest_version": 3
}

مجوزهای میزبان

مجوزهای میزبان به برنامه های افزودنی اجازه می دهد تا با الگوهای منطبق URL تعامل داشته باشند. برخی از APIهای Chrome علاوه بر مجوزهای API خود، که در هر صفحه مرجع مستند شده است، به مجوزهای میزبان نیز نیاز دارند. در اینجا چند نمونه آورده شده است:

مجوزها با اخطار

هنگامی که یک برنامه افزودنی چندین مجوز درخواست می کند و بسیاری از آنها هشدارهایی را هنگام نصب نشان می دهند، کاربر لیستی از هشدارها را می بیند، مانند مثال زیر: