宣告權限

大部分 Chrome 都可使用。*API 所述,您的擴充功能或應用程式必須在資訊清單的「permissions」欄位中宣告意圖。每項權限可以是一份已知字串清單 (例如「地理位置」),或是提供存取一或多個主機的「比對模式」。權限有助於限制擴充功能或應用程式遭到惡意軟體攻擊時造成的損害。系統也會在安裝前向使用者顯示部分權限,如權限警告一節所述。

如果 API 要求您在資訊清單中宣告權限,請參閱 API 的說明文件,瞭解如何宣告權限。舉例來說,「Storage」頁面會說明如何宣告「儲存空間」權限。

以下是資訊清單檔案的權限部分範例:

"permissions": [
  "tabs",
  "bookmarks",
  "http://www.blogger.com/",
  "http://*.google.com/",
  "unlimitedStorage"
],

下表列出目前可用的權限:

權限 說明
"activeTab" 要求根據 activeTab 規格取得擴充功能的權限。
"alarms" 授予擴充功能 chrome.alarms API 的存取權。
"background"

請讓 Chrome 及早啟動,並延遲關閉,讓應用程式和擴充功能延長壽命。

如果已安裝的代管應用程式、封裝應用程式或擴充功能具備「背景」權限,使用者只要登入電腦,Chrome 就會立即執行 (隱形)。「背景」權限也會讓 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" 允許擴充功能或應用程式使用 geolocation API,而不提示使用者授予權限。
"history" 授予擴充功能 chrome.history API 的存取權。
"identity" 授予擴充功能 chrome.identity API 的存取權。
"idle" 授予擴充功能存取 chrome.idle API 的權限。
"loginState" 授予擴充功能存取 chrome.loginState API 的權限。
"management" 授予擴充功能 chrome.management API 的存取權。
"nativeMessaging" 授予擴充功能存取原生訊息 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 使用的 Tab 物件權限欄位,包括 chrome.tabschrome.windows。在多數情況下,擴充功能無須宣告 "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 的存取權。
"wallpaper" 授予擴充功能存取 chrome.wallpaper API。
"webNavigation" 授予擴充功能存取 chrome.webNavigation API 的權限。
"webRequest" 授予擴充功能存取 chrome.webRequest API 的權限。
"webRequestBlocking" 如果擴充功能以封鎖方式使用 chrome.webRequest API,則必須使用此 API。