如要使用大部分的 chrome.* API,擴充功能或應用程式必須在資訊清單的「permissions」欄位中宣告其意圖。每項權限可以是已知字串清單中的其中一項 (例如「geolocation」),也可以是授予一或多個主機存取權的比對模式。如果擴充功能或應用程式遭到惡意軟體入侵,權限可協助限制損害。部分權限也會在安裝前向使用者顯示,詳情請參閱「權限警告」。
如果 API 要求您在資訊清單中宣告權限,說明文件會說明如何操作。舉例來說,「儲存空間」頁面會說明如何宣告「儲存空間」權限。
以下是資訊清單檔案中權限部分的範例:
"permissions": [
"tabs",
"bookmarks",
"http://www.blogger.com/",
"http://*.google.com/",
"unlimitedStorage"
],
下表列出目前可用的權限:
| 權限 | 說明 |
|---|---|
"activeTab" |
要求根據 activeTab 規格授予擴充功能權限。 |
"alarms" |
允許擴充功能存取 chrome.alarms API。 |
"background" |
讓 Chrome 提早啟動並延後關閉,延長應用程式和擴充功能的運作時間。 如果任何已安裝的代管應用程式、封裝應用程式或擴充功能具有「背景」權限,Chrome 就會在使用者登入電腦後立即在背景執行,不必等到使用者啟動 Chrome。「background」權限也會讓 Chrome 繼續執行 (即使最後一個視窗已關閉),直到使用者明確退出 Chrome 為止。 注意:系統會將停用的應用程式和擴充功能視為未安裝。
|
"bookmarks" |
允許擴充功能存取 chrome.bookmarks API。 |
"browsingData" |
允許擴充功能存取 chrome.browsingData API。 |
"certificateProvider" |
允許擴充功能存取 chrome.certificateProvider API。 |
"clipboardRead" |
如果擴充功能或應用程式使用 document.execCommand('paste'),則為必填。 |
"clipboardWrite" |
指出擴充功能或應用程式使用 document.execCommand('copy') 或 document.execCommand('cut')。代管應用程式必須具備這項權限,建議擴充功能和封裝應用程式也具備這項權限。 |
"contentSettings" |
允許擴充功能存取 chrome.contentSettings API。 |
"contextMenus" |
授予擴充功能 chrome.contextMenus API 的存取權。 |
"cookies" |
授予擴充功能 chrome.cookies API 的存取權。 |
"debugger" |
允許擴充功能存取 chrome.debugger API。 |
"declarativeContent" |
允許擴充功能存取 chrome.declarativeContent API。 |
"declarativeNetRequest" |
允許擴充功能存取 chrome.declarativeNetRequest API。 |
"declarativeNetRequestFeedback" |
授予擴充功能存取 chrome.declarativeNetRequest API 中事件和方法的權限,這些事件和方法會傳回相符宣告規則的資訊。 |
"declarativeWebRequest" |
允許擴充功能存取 chrome.declarativeWebRequest API。 |
"desktopCapture" |
授予擴充功能 chrome.desktopCapture API 的存取權。 |
"documentScan" |
允許擴充功能存取 chrome.documentScan API。 |
"downloads" |
允許擴充功能存取 chrome.downloads API。 |
"enterprise.deviceAttributes" |
允許擴充功能存取 chrome.enterprise.deviceAttributes API。 |
"enterprise.hardwarePlatform" |
允許擴充功能存取 chrome.enterprise.hardwarePlatform API。 |
"enterprise.networkingAttributes" |
允許擴充功能存取 chrome.enterprise.networkingAttributes API。 |
"enterprise.platformKeys" |
允許擴充功能存取 chrome.enterprise.platformKeys API。 |
"experimental" |
如果擴充功能或應用程式使用任何 chrome.experimental.* API。 |
"fileBrowserHandler" |
允許擴充功能存取 chrome.fileBrowserHandler API。 |
"fileSystemProvider" |
允許擴充功能存取 chrome.fileSystemProvider API。 |
"fontSettings" |
授予擴充功能 chrome.fontSettings API 的存取權。 |
"gcm" |
允許擴充功能存取 chrome.gcm API。 |
"geolocation" |
允許擴充功能或應用程式使用地理位置 API,不需提示使用者授予權限。 |
"history" |
允許擴充功能存取 chrome.history API。 |
"identity" |
允許擴充功能存取 chrome.identity API。 |
"idle" |
允許擴充功能存取 chrome.idle API。 |
"loginState" |
允許擴充功能存取 chrome.loginState API。 |
"management" |
授予擴充功能 chrome.management API 的存取權。 |
"nativeMessaging" |
授予擴充功能 Native Messaging API 的存取權。 |
"notifications" |
允許擴充功能存取 chrome.notifications API。 |
"pageCapture" |
允許擴充功能存取 chrome.pageCapture API。 |
"platformKeys" |
允許擴充功能存取 chrome.platformKeys API。 |
"power" |
允許擴充功能存取 chrome.power API。 |
"printerProvider" |
允許擴充功能存取 chrome.printerProvider API。 |
"printing" |
授予擴充功能 chrome.printing API 的存取權。 |
"printingMetrics" |
允許擴充功能存取 chrome.printingMetrics API。 |
"privacy" |
允許擴充功能存取 chrome.privacy API。 |
"processes" |
允許擴充功能存取 chrome.processes API。 |
"proxy" |
允許擴充功能存取 chrome.proxy API。 |
"scripting" |
授予擴充功能 chrome.scripting API 的存取權。 |
"search" |
允許擴充功能存取 chrome.search API。 |
"sessions" |
允許擴充功能存取 chrome.sessions API。 |
"signedInDevices" |
允許擴充功能存取 chrome.signedInDevices API。 |
"storage" |
授予擴充功能 chrome.storage API 的存取權。 |
"system.cpu" |
授予擴充功能 chrome.system.cpu API 的存取權。 |
"system.display" |
允許擴充功能存取 chrome.system.display API。 |
"system.memory" |
允許擴充功能存取 chrome.system.memory API。 |
"system.storage" |
允許擴充功能存取 chrome.system.storage API。 |
"tabCapture" |
允許擴充功能存取 chrome.tabCapture API。 |
"tabGroups" |
允許擴充功能存取 chrome.tabGroups API。 |
"tabs" |
允許擴充功能存取多個 API (包括 chrome.tabs 和 chrome.windows) 使用的 Tab 物件特殊權限欄位。在許多情況下,擴充功能不需要宣告 "tabs" 權限,即可使用這些 API。 |
"topSites" |
允許擴充功能存取 chrome.topSites API。 |
"tts" |
允許擴充功能存取 chrome.tts API。 |
"ttsEngine" |
允許擴充功能存取 chrome.ttsEngine API。 |
"unlimitedStorage" |
提供無限配額,可用於儲存用戶端資料,例如資料庫和本機儲存空間檔案。
如果沒有這項權限,擴充功能或應用程式的本機儲存空間上限為 5 MB。 注意:這項權限僅適用於網路 SQL 資料庫和應用程式快取 (請參閱問題 58985)。此外,這項功能目前不支援萬用字元子網域,例如
http://*.example.com。 |
"vpnProvider" |
允許擴充功能存取 chrome.vpnProvider API。 |
"webNavigation" |
授予擴充功能 chrome.webNavigation API 的存取權。 |
"webRequest" |
允許擴充功能存取 chrome.webRequest API。 |
"webRequestBlocking" |
如果擴充功能以封鎖方式使用 chrome.webRequest API,則必須提供這項資訊。 |