如要使用大部分 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 的存取權。 |
"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 使用的 Tab 物件的特殊欄位,包括 chrome.tabs 和 chrome.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,則為必要屬性。 |