宣告權限

使用大多數的 Chrome。*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 繼續執行 (即使在最後一個視窗關閉後),直到使用者明確為止 關閉 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 中的事件和方法,這個 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,則為必要屬性。