כדי להשתמש ברוב Chrome.* ממשקי API, התוסף או האפליקציה צריכים להצהיר על הכוונה שלהם בשדה "Permissions" במניפסט. כל הרשאה יכולה להיות רשימה מתוך רשימה של מחרוזות ידועות (כמו "מיקום גיאוגרפי") או תבנית התאמה שמעניקה גישה למארח אחד או יותר. ההרשאות עוזרות להגביל את הנזק אם התוסף או האפליקציה נחשפו על ידי תוכנה זדונית. חלק מההרשאות מוצגות גם למשתמשים לפני ההתקנה, כפי שמפורט באזהרות לגבי הרשאות.
אם אתם נדרשים להצהיר על הרשאה ב-API, תוכלו להיעזר במסמכי התיעוד שלו כדי להבין איך לעשות זאת, למשל בדף אחסון שבו מוסבר איך להצהיר על הרשאת 'אחסון'.
הנה דוגמה לחלק של ההרשאות בקובץ מניפסט:
"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" |
מעניק לתוסף גישה אל chrome.browsingData API. |
"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" |
התוסף מעניק לתוסף גישה אל chrome.declarativeNetRequest. |
"declarativeNetRequestFeedback" |
מעניק לתוסף גישה לאירועים ולשיטות בתוך ה-API של chrome.declarativeNetRequest, שמחזירה מידע על כללים מוצהרים תואמים. |
"declarativeWebRequest" |
מעניק לתוסף גישה אל ה-API chrome.declarativeWebRequest. |
"desktopCapture" |
מעניק לתוסף גישה אל ה-API של chrome.desktopCapture. |
"documentScan" |
מעניק לתוסף גישה אל ה-API chrome.documentScan. |
"downloads" |
מעניק לתוסף גישה אל ה-API של chrome.downloads. |
"enterprise.deviceAttributes" |
התוסף מעניק לתוסף גישה ל-chrome.enterprise.deviceAttributes API. |
"enterprise.hardwarePlatform" |
התוסף מעניק לתוסף גישה ל-chrome.enterprise.hardwarePlatform. |
"enterprise.networkingAttributes" |
התוסף מעניק לתוסף גישה אל chrome.enterprise.networkingAttributes API. |
"enterprise.platformKeys" |
התוסף מעניק לתוסף גישה ל-chrome.enterprise.platformKeys API. |
"experimental" |
חובה אם התוסף או האפליקציה משתמשים ב-chrome.engagemental.* ממשקי API. |
"fileBrowserHandler" |
מעניק לתוסף גישה אל ה-API של chrome.fileBrowserHandler. |
"fileSystemProvider" |
מעניק לתוסף גישה ל-API של chrome.fileSystemProvider. |
"fontSettings" |
מעניק לתוסף גישה אל ה-API של chrome.fontSettings. |
"gcm" |
התוסף מעניק לתוסף גישה אל ה-API של chrome.gcm. |
"geolocation" |
ההרשאה הזו מאפשרת לתוסף או לאפליקציה להשתמש בממשק ה-API למיקום גיאוגרפי בלי לבקש מהמשתמש הרשאה. |
"history" |
התוסף מעניק לתוסף גישה אל chrome.history API. |
"identity" |
התוסף מעניק לתוסף גישה ל-API chrome.identity. |
"idle" |
התוסף מעניק לתוסף גישה אל chrome.idle API. |
"loginState" |
מעניק לתוסף גישה אל ה-API chrome.loginState. |
"management" |
מעניק לתוסף גישה אל ה-API של chrome.management. |
"nativeMessaging" |
מעניק לתוסף גישה לממשק ה-API להעברת הודעות באפליקציות מותאמות. |
"notifications" |
התוסף מעניק לתוסף גישה ל-API של chrome.notifications. |
"pageCapture" |
התוסף מעניק לתוסף גישה אל chrome.pageCapture API. |
"platformKeys" |
התוסף מעניק לתוסף גישה אל chrome.platformKeys API. |
"power" |
מעניק לתוסף גישה אל ה-API של chrome.power. |
"printerProvider" |
התוסף נותן לתוסף גישה ל-API של chrome.printerProvider. |
"printing" |
התוסף מעניק לתוסף גישה אל ה-API chrome.printing. |
"printingMetrics" |
התוסף מעניק לתוסף גישה אל 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" |
התוסף מעניק לתוסף גישה אל 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" |
מעניק לתוסף גישה ל-chrome.ttsEngine API. |
"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 באופן חסימה. |