在指令清單中宣告 API 許可權
若要使用大部分的 chrome.* API，您的擴充功能必須在指令清單的欄位中 permissions 宣告其意圖。 延伸模組可以使用下表中的許可權字串來宣告許可權，或使用模式來比對類似的字串。 如果擴充功能遭到惡意代碼入侵，許可權有助於限制擴充功能。 在安裝擴充功能之前或在運行時間，會視需要向用戶顯示某些許可權以取得其同意;這些是許可權警告。
如果 API 要求您在指令清單中宣告許可權，請參閱該 API 的檔，以瞭解所需的許可權。 例如， [記憶體 API] 頁面描述如何宣告權 storage 限。
以下是指令清單檔案的許可權部分範例：
"permissions": [
"tabs",
"bookmarks",
"storage"
],
"optional_permissions": [
"unlimitedStorage"
],
"host_permissions": [
"http://www.blogger.com/",
"http://*.google.com/"
],
下表列出要在指令清單中使用的目前可用許可權字串，以及描述。
| 許可權字串 | 詳細資料 |
|---|---|
activeTab |
要求根據規格授與擴充功能的 activeTab 許可權。 |
alarms |
為您的擴充功能提供 API 的 chrome.alarms 存取權。 |
background |
讓Microsoft Edge 提早啟動並延遲關機，讓擴充功能的使用時間更長。 當任何已安裝的擴充功能具有 background 許可權時，只要使用者登入用戶的計算機，以及在用戶啟動之前，Microsoft Edge 就會以可見的方式執行Microsoft Edge。 此 background 許可權也會讓Microsoft Edge 繼續執行，即使在關閉其最後一個窗口之後，直到使用者明確結束Microsoft Edge 為止。 注意： 停用的擴充功能會被視為未安裝。 您應該使用權 background 限搭配 背景腳本。 |
bookmarks |
為您的擴充功能提供 API 的 chrome.bookmarks 存取權。 |
browsingData |
為您的擴充功能提供 API 的 chrome.browsingData 存取權。 |
certificateProvider |
為您的擴充功能提供 API 的 chrome.certificateProvider 存取權。 |
clipboardRead |
如果擴充功能使用 ，則為必要專案 document.execCommand('paste')。 |
clipboardWrite |
表示延伸模組使用 document.execCommand('copy') 或 document.execCommand('cut')。 |
contentSettings |
為您的擴充功能提供 API 的 chrome.contentSettings 存取權。 |
contextMenus |
為您的擴充功能提供 API 的 chrome.contextMenus 存取權。 |
cookies |
為您的擴充功能提供 API 的 chrome.cookies 存取權。 |
debugger |
為您的擴充功能提供 API 的 chrome.debugger 存取權。 |
declarativeContent |
為您的擴充功能提供 API 的 chrome.declarativeContent 存取權。 |
declarativeNetRequest |
為您的擴充功能提供 API 的 chrome.declarativeNetRequest 存取權。 允許擴充功能封鎖和升級要求，而不需要主機許可權，但需要主機許可權才能重新導向要求或修改標頭。 |
declarativeNetRequestWithHostAccess |
為您的擴充功能提供 API 的 chrome.declarativeNetRequest 存取權。 一律需要要求 URL 和啟動器上的主機許可權，才能對要求採取行動。 |
declarativeNetRequestFeedback |
授與 API 內事件和方法的 chrome.declarativeNetRequest 延伸模組存取權，這會傳回相符宣告式規則的相關信息。 |
declarativeWebRequest |
為您的擴充功能提供 API 的 chrome.declarativeWebRequest 存取權。 |
desktopCapture |
為您的擴充功能提供 API 的 chrome.desktopCapture 存取權。 |
documentScan |
為您的擴充功能提供 API 的 chrome.documentScan 存取權。 |
downloads |
為您的擴充功能提供 API 的 chrome.downloads 存取權。 |
enterprise.deviceAttributes |
為您的擴充功能提供 API 的 chrome.enterprise.deviceAttributes 存取權。 |
enterprise.hardwarePlatform |
為您的擴充功能提供 API 的 chrome.enterprise.hardwarePlatform 存取權。 |
enterprise.networkingAttributes |
為您的擴充功能提供 API 的 chrome.enterprise.networkingAttributes 存取權。 |
enterprise.platformKeys |
為您的擴充功能提供 API 的 chrome.enterprise.platformKeys 存取權。 |
experimental |
如果擴充功能使用任何 chrome.experimental.* API，則為必要專案。 |
fileBrowserHandler |
為您的擴充功能提供 API 的 chrome.fileBrowserHandler 存取權。 |
fileSystemProvider |
為您的擴充功能提供 API 的 chrome.fileSystemProvider 存取權。 |
fontSettings |
為您的擴充功能提供 API 的 chrome.fontSettings 存取權。 |
geolocation |
允許擴充功能使用地理位置 API，而不會提示使用者提供許可權。 |
history |
為您的擴充功能提供 API 的 chrome.history 存取權。 |
identity |
為您的擴充功能提供 API 的 chrome.identity 存取權。 |
idle |
為您的擴充功能提供 API 的 chrome.idle 存取權。 |
loginState |
為您的擴充功能提供 API 的 chrome.loginState 存取權。 |
management |
為您的擴充功能提供 API 的 chrome.management 存取權。 |
nativeMessaging |
提供原生傳訊 API 的擴充功能存取權。 |
notifications |
為您的擴充功能提供 API 的 chrome.notifications 存取權。 |
pageCapture |
為您的擴充功能提供 API 的 chrome.pageCapture 存取權。 |
platformKeys |
為您的擴充功能提供 API 的 chrome.platformKeys 存取權。 |
power |
為您的擴充功能提供 API 的 chrome.power 存取權。 |
printerProvider |
為您的擴充功能提供 API 的 chrome.printerProvider 存取權。 |
printing |
為您的擴充功能提供 API 的 chrome.printing 存取權。 |
printingMetrics |
為您的擴充功能提供 API 的 chrome.printingMetrics 存取權。 |
privacy |
為您的擴充功能提供 API 的 chrome.privacy 存取權。 |
processes |
為您的擴充功能提供 API 的 chrome.processes 存取權。 |
proxy |
為您的擴充功能提供 API 的 chrome.proxy 存取權。 |
scripting |
為您的擴充功能提供 API 的 chrome.scripting 存取權。 |
search |
為您的擴充功能提供 API 的 chrome.search 存取權。 |
sessions |
為您的擴充功能提供 API 的 chrome.sessions 存取權。 |
sidePanel |
為您的擴充功能提供 API 的 chrome.sidePanel 存取權。 請參閱 開發 Microsoft Edge 提要字段的擴充功能。 |
signedInDevices |
為您的擴充功能提供 API 的 chrome.signedInDevices 存取權。 |
storage |
為您的擴充功能提供 API 的 chrome.storage 存取權。 |
system.cpu |
為您的擴充功能提供 API 的 chrome.system.cpu 存取權。 |
system.display |
為您的擴充功能提供 API 的 chrome.system.display 存取權。 |
system.memory |
為您的擴充功能提供 API 的 chrome.system.memory 存取權。 |
system.storage |
為您的擴充功能提供 API 的 chrome.system.storage 存取權。 |
tabCapture |
為您的擴充功能提供 API 的 chrome.tabCapture 存取權。 |
tabGroups |
為您的擴充功能提供 API 的 chrome.tabGroups 存取權。 |
tabs |
讓您的擴充功能能夠存取 Tab 物件的特殊權限欄位，這些欄位可供數個 API 使用，包括 chrome.tabs 和 chrome.windows。 在許多情況下，您的擴充功能不需要宣告 tabs 許可權，即可使用這些 API。 |
topSites |
為您的擴充功能提供 API 的 chrome.topSites 存取權。 |
tts |
為您的擴充功能提供 API 的 chrome.tts 存取權。 |
ttsEngine |
為您的擴充功能提供 API 的 chrome.ttsEngine 存取權。 |
unlimitedStorage |
提供無限制的配額來儲存客戶端數據，例如資料庫和本機記憶體檔案。 如果沒有此許可權，擴充功能就限制為5 MB 的本機記憶體。 此許可權僅適用於 Web SQL Database 和應用程式快取 (請參閱問題 58985：無限制記憶體許可權應套用至本機記憶體) 。 此權限目前不適用於通配符子域，例如 http://*.contoso.com。 |
vpnProvider |
為您的擴充功能提供 API 的 chrome.vpnProvider 存取權。 |
wallpaper |
為您的擴充功能提供 API 的 chrome.wallpaper 存取權。 |
webNavigation |
為您的擴充功能提供 API 的 chrome.webNavigation 存取權。 |
webRequest |
為您的擴充功能提供 API 的 chrome.webRequest 存取權。 |
webRequestBlocking |
如果擴充功能使用 API 來封鎖要求， chrome.webRequest 則為必要專案。 |
注意事項
此頁面的部分是根據Google所建立和 共用的工作進行 修改，並根據 Creative Commons Attribution 4.0 國際授權中所述的條款使用。 您可以 在這裡找到原始頁面。
此工作是根據 Creative Commons Attribution 4.0 International License 授權。