宣告權限

如要使用大部分的 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 的存取權。
"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,則必須提供這項資訊。