כדי להשתמש ברוב הפורמטים של Chrome.* ממשקי API, התוסף או האפליקציה חייבים להצהיר על הכוונה שלהם בקטע 'הרשאות' שדה של המניפסט. כל הרשאה יכולה להיות אחת מרשימה של מחרוזות ידועות (כמו 'geolocation') או דפוס התאמה שמעניק גישה למארח אחד או יותר. ההרשאות עוזרות ל: להגביל את הנזקים אם התוסף או האפליקציה נפרצים על ידי תוכנה זדונית. מוצגות גם חלק מההרשאות למשתמשים לפני ההתקנה, כפי שמפורט באזהרות על הרשאות.
אם נדרשת הצהרה על הרשאה ב-API במניפסט, התיעוד שלו יסביר איך לעשות זאת. לדוגמה, בדף אחסון מוסבר איך להצהיר (declare) על 'אחסון'. הרשאה.
דוגמה לחלק של ההרשאות בקובץ מניפסט:
"permissions": [
"tabs",
"bookmarks",
"http://www.blogger.com/",
"http://*.google.com/",
"unlimitedStorage"
],
בטבלה הבאה מפורטות ההרשאות שזמינות כרגע:
| הרשאה | תיאור |
|---|---|
"activeTab" |
בקשות לקבלת הרשאות לתוסף בהתאם לכרטיסייה activeTab למפרט. |
"alarms" |
מעניקה לתוסף גישה ל-API chrome.alarms. |
"background" |
ההגדרה גורמת ל-Chrome להתחיל להיסגר מוקדם יותר ולהיסגר מאוחר, כדי שהאפליקציות והתוספים יהיו ארוכים יותר חיים. כאשר אפליקציה מתארחת, אפליקציה ארוזה או תוסף מותקנים במצב "רקע" הרשאה, Chrome מפעיל (באופן בלתי נראה) ברגע שהמשתמש מתחבר למחשב שלו - לפני שהמשתמש מפעיל את Chrome. ה"רקע" הרשאה גורמת גם לכך ש-Chrome ימשיך לפעול (גם אחרי שהחלון האחרון שלו נסגר) עד שהמשתמש יוצא מ-Chrome. הערה: אפליקציות ותוספים מושבתים מתייחסים כאילו הם לא
מותקנת.
בדרך כלל משתמשים ב'רקע' עם דף רקע, דף אירוע או חלון רקע (לאפליקציות מתארחות). |
"bookmarks" |
מעניקה לתוסף גישה ל-API chrome.bookmarks. |
"browsingData" |
מעניקה לתוסף גישה ל-API chrome.browsingData. |
"certificateProvider" |
מעניקה לתוסף גישה ל-API chrome.certificateProvider. |
"clipboardRead" |
חובה אם התוסף או האפליקציה משתמשים ב-document.execCommand('paste'). |
"clipboardWrite" |
מציין שהתוסף או האפליקציה משתמשים ב-document.execCommand('copy') או
document.execCommand('cut'). ההרשאה הזו נדרשת לאפליקציות מתארחות. מומלץ
לתוספים ולאפליקציות ארוזות. |
"contentSettings" |
מעניקה לתוסף גישה ל-API chrome.contentSettings. |
"contextMenus" |
מעניקה לתוסף גישה ל-API chrome.contextMenus. |
"cookies" |
מעניקה לתוסף גישה ל-API chrome.cookies. |
"debugger" |
מעניקה לתוסף גישה ל-API chrome.debugger. |
"declarativeContent" |
מעניקה לתוסף גישה ל-chrome.declarativeContent API. |
"declarativeNetRequest" |
מעניקה לתוסף גישה ל-API chrome.declarativeNetRequest. |
"declarativeNetRequestFeedback" |
התפקיד הזה מעניק לתוסף גישה לאירועים ולשיטות ב-chrome.declarativeNetRequest API שמחזירים מידע על שתואמים לכללים. |
"declarativeWebRequest" |
מעניקה לתוסף גישה ל-API chrome.declarativeWebRequest. |
"desktopCapture" |
מעניקה לתוסף גישה ל-API chrome.desktopCapture. |
"documentScan" |
מעניקה לתוסף גישה ל-API chrome.documentScan. |
"downloads" |
מעניקה לתוסף גישה ל-API chrome.downloads. |
"enterprise.deviceAttributes" |
מעניקה לתוסף גישה ל-API chrome.enterprise.deviceAttributes. |
"enterprise.hardwarePlatform" |
מעניקה לתוסף גישה ל-API chrome.enterprise.hardwarePlatform. |
"enterprise.networkingAttributes" |
מעניקה לתוסף גישה ל-API chrome.enterprise.networkingAttributes. |
"enterprise.platformKeys" |
מעניקה לתוסף גישה ל-API chrome.enterprise.platformKeys. |
"experimental" |
חובה אם התוסף או האפליקציה משתמשים באחד מהמאפיינים chrome.experimental.* ממשקי API. |
"fileBrowserHandler" |
מעניקה לתוסף גישה ל-API chrome.fileBrowserHandler. |
"fileSystemProvider" |
מעניקה לתוסף גישה ל-API chrome.fileSystemProvider. |
"fontSettings" |
מעניקה לתוסף גישה ל-API chrome.fontSettings. |
"gcm" |
מעניקה לתוסף גישה ל-API chrome.gcm. |
"geolocation" |
מאפשרת לתוסף או לאפליקציה להשתמש ב-geolocation API בלי להציג בקשה למשתמש הרשאה. |
"history" |
מעניקה לתוסף גישה ל-API chrome.history. |
"identity" |
מעניקה לתוסף גישה ל-API chrome.identity. |
"idle" |
מעניקה לתוסף גישה ל-API chrome.idle. |
"loginState" |
מעניקה לתוסף גישה ל-API chrome.loginState. |
"management" |
מעניקה לתוסף גישה אל chrome.management API. |
"nativeMessaging" |
מעניקה לתוסף גישה ל-API להעברת הודעות נייטיב. |
"notifications" |
מעניקה לתוסף גישה ל-API chrome.notifications. |
"pageCapture" |
מעניקה לתוסף גישה אל chrome.pageCapture API. |
"platformKeys" |
מעניקה לתוסף גישה ל-API chrome.platformKeys. |
"power" |
מעניקה לתוסף גישה ל-API chrome.power. |
"printerProvider" |
מעניקה לתוסף גישה ל-API chrome.printerProvider. |
"printing" |
מעניקה לתוסף גישה ל-API chrome.printing. |
"printingMetrics" |
מעניקה לתוסף גישה ל-API chrome.printingMetrics. |
"privacy" |
מעניקה לתוסף גישה ל-API chrome.privacy. |
"processes" |
מעניקה לתוסף גישה ל-API chrome.processes. |
"proxy" |
מעניקה לתוסף גישה ל-API chrome.proxy. |
"scripting" |
מעניקה לתוסף גישה ל-API chrome.scripting. |
"search" |
מעניקה לתוסף גישה ל-API chrome.search. |
"sessions" |
מעניקה לתוסף גישה ל-API chrome.sessions. |
"signedInDevices" |
מעניקה לתוסף גישה ל-API chrome.signedInDevices. |
"storage" |
מעניקה לתוסף גישה ל-API chrome.storage. |
"system.cpu" |
מעניקה לתוסף גישה ל-API chrome.system.cpu. |
"system.display" |
מעניקה לתוסף גישה לממשק ה-API chrome.system.display. |
"system.memory" |
מעניקה לתוסף גישה ל-API chrome.system.memory. |
"system.storage" |
מעניקה לתוסף גישה ל-API chrome.system.storage. |
"tabCapture" |
מעניקה לתוסף גישה ל-API chrome.tabCapture. |
"tabGroups" |
מעניקה לתוסף גישה ל-API chrome.tabGroups. |
"tabs" |
מעניקה לתוסף גישה לשדות בעלי הרשאות של האובייקטים Tab שמשמשים מספר ממשקי API
כולל chrome.tabs ו-chrome.windows. לחשבון
בהרבה מקרים אין צורך להצהיר על ההרשאה ל-"tabs" כדי להשתמש בתוסף
ממשקי ה-API האלה. |
"topSites" |
מעניקה לתוסף גישה לממשק ה-API של chrome.topSites. |
"tts" |
מעניקה לתוסף גישה ל-API chrome.tts. |
"ttsEngine" |
מעניקה לתוסף גישה ל-API של chrome.ttsEngine. |
"unlimitedStorage" |
מאפשרת מכסה בלתי מוגבלת לאחסון נתונים בצד הלקוח, כמו מסדי נתונים וקובצי אחסון מקומי.
ללא ההרשאה הזו, התוסף או האפליקציה מוגבלים ל-5MB של אחסון מקומי. הערה: ההרשאה הזו חלה רק על מסד נתוני Web SQL ועל מטמון של אפליקציות
(יש לעיין בגיליון 58985). כמו כן, היא לא פועלת כרגע עם תו כללי לחיפוש
תת-דומיינים כמו
http://*.example.com. |
"vpnProvider" |
מעניקה לתוסף גישה ל-API chrome.vpnProvider. |
"wallpaper" |
מעניקה לתוסף גישה ל-API chrome.wallpaper. |
"webNavigation" |
מעניקה לתוסף גישה ל-chrome.webNavigation API. |
"webRequest" |
מעניקה לתוסף גישה ל-API chrome.webRequest. |
"webRequestBlocking" |
חובה אם התוסף משתמש ב-API chrome.webRequest באופן חוסם. |