宣告權限

如要使用大部分 Chrome 功能,請按照下列步驟操作:*API、擴充功能或應用程式必須在manifest的「權限」欄位中宣告意圖。每項權限可以是已知字串清單中的其中一個字串 (例如「geolocation」),或是授予一個以上主機存取權的比對模式。當擴充功能或應用程式遭到惡意軟體入侵時,權限有助於限制損害。在安裝前,系統也會向使用者顯示部分權限,詳情請參閱「權限警告」。

如果 API 要求您在資訊清單中宣告權限,其說明文件會說明如何操作。例如,「儲存空間」頁面會說明如何宣告「儲存空間」權限。

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

"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 中事件和方法的權限,以便傳回符合宣告式規則的資訊。
"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" 為擴充功能授予原生訊息 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,則為必要屬性。