# 权限声明

扩展可以请求三类权限,使用清单中的相应键指定:

  • permissions包含已知字符串列表中的项目(例如“地理位置”)
  • optional_permissions类似于常规permissions,但由扩展的用户在运行时授予,而不是提前授予
  • host_permissions包含一个或多个匹配模式,可以访问一个或多个主机

# 清单文件

清单文件示例如下:

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

# 当前可用权限

允许 描述
"activeTab" 请求根据activeTab (opens new window)规范授予扩展权限。
"alarms" 为您的扩展提供对chrome.alarms (opens new window) API 的访问权限。
"background" 让 Chrome 早起晚关,让扩展的寿命更长。当任何已安装的扩展程序具有“后台”权限时,Chrome 会在用户登录其计算机后立即运行(不可见)——在用户启动 Chrome 之前。“后台”权限还使 Chrome 继续运行(即使在其最后一个窗口关闭后),直到用户明确退出 Chrome。**注意:**禁用的扩展被视为没有安装。您应该在后台脚本 (opens new window)中使用“后台”权限。
"bookmarks" 让您的扩展程序访问chrome.bookmarks (opens new window) API。
"browsingData" 让您的扩展访问chrome.browsingData (opens new window) API。
"certificateProvider" 为您的扩展提供对chrome.certificateProvider (opens new window) API 的访问权限。
"clipboardRead" 如果扩展使用document.execCommand('paste').
"clipboardWrite" 如果扩展使用document.execCommand('copy')or ,则为必需document.execCommand('cut')
"contentSettings" 让您的扩展程序访问chrome.contentSettings (opens new window) API。
"contextMenus" 为您的扩展提供对chrome.contextMenus (opens new window) API 的访问权限。
"cookies" 让您的扩展访问chrome.cookies (opens new window) API。
"debugger" 为您的扩展提供对chrome.debugger (opens new window) API 的访问权限。
"declarativeContent" 让您的扩展访问chrome.declarativeContent (opens new window) API。
"declarativeNetRequest" 为您的扩展提供对chrome.declarativeNetRequest (opens new window) API 的访问权限。
"declarativeNetRequestFeedback" 授予扩展访问chrome.declarativeNetRequest (opens new window) API 中的事件和方法的权限,这些事件和方法返回有关匹配的声明性规则的信息。
"declarativeWebRequest" 让您的扩展访问chrome.declarativeWebRequest (opens new window) API。
"desktopCapture" 为您的扩展提供对chrome.desktopCapture (opens new window) API 的访问权限。
"documentScan" 让您的扩展访问chrome.documentScan (opens new window) API。
"downloads" 为您的扩展提供对chrome.downloads (opens new window) API 的访问权限。
"enterprise.deviceAttributes" 为您的扩展提供对chrome.enterprise.deviceAttributes (opens new window) API 的访问权限。
"enterprise.hardwarePlatform" 让您的扩展访问chrome.enterprise.hardwarePlatform (opens new window) API。
"enterprise.networkingAttributes" 为您的扩展提供对chrome.enterprise.networkingAttributes (opens new window) API 的访问权限。
"enterprise.platformKeys" 让您的扩展访问chrome.enterprise.platformKeys (opens new window) API。
"experimental" 如果扩展程序使用任何chrome.experimental.* API (opens new window) ,则为必需。
"fileBrowserHandler" 让您的扩展访问chrome.fileBrowserHandler (opens new window) API。
"fileSystemProvider" 让您的扩展访问chrome.fileSystemProvider (opens new window) API。
"fontSettings" 让你的扩展访问chrome.fontSettings (opens new window) API。
"gcm" 让您的扩展访问chrome.gcm (opens new window) API。
"geolocation" 允许扩展程序在不提示用户许可的情况下使用地理定位 API 。 (opens new window)
"history" 为您的扩展提供对chrome.history (opens new window) API 的访问权限。
"identity" 让你的扩展访问chrome.identity (opens new window) API。
"idle" 为您的扩展提供对chrome.idle (opens new window) API 的访问权限。
"loginState" 让你的扩展访问chrome.loginState (opens new window) API。
"management" 让您的扩展访问chrome.management (opens new window) API。
"nativeMessaging" 让您的扩展访问本机消息 API (opens new window)
"notifications" 让您的扩展访问chrome.notifications (opens new window) API。
"pageCapture" 让您的扩展访问chrome.pageCapture (opens new window) API。
"platformKeys" 为您的扩展提供对chrome.platformKeys (opens new window) API 的访问权限。
"power" 为您的扩展提供对chrome.power (opens new window) API 的访问权限。
"printerProvider" 让您的扩展访问chrome.printerProvider (opens new window) API。
"printing" 让您的扩展访问chrome.printing (opens new window) API。
"printingMetrics" 让您的扩展访问chrome.printingMetrics (opens new window) API。
"privacy" 让您的扩展访问chrome.privacy (opens new window) API。
"processes" 为您的扩展提供对chrome.processes (opens new window) API 的访问权限。
"proxy" 让您的扩展访问chrome.proxy (opens new window) API。
"scripting" 为您的扩展提供对chrome.scripting (opens new window) API 的访问权限。
"search" 为您的扩展提供对chrome.search (opens new window) API 的访问权限。
"sessions" 让您的扩展访问chrome.sessions (opens new window) API。
"signedInDevices" 为您的扩展提供对chrome.signedInDevices (opens new window) API 的访问权限。
"storage" 为您的扩展提供对chrome.storage (opens new window) API 的访问权限。
"system.cpu" 让您的扩展访问chrome.system.cpu (opens new window) API。
"system.display" 让您的扩展访问chrome.system.display (opens new window) API。
"system.memory" 让您的扩展访问chrome.system.memory (opens new window) API。
"system.storage" 让你的扩展访问chrome.system.storage (opens new window) API。
"tabCapture" 为您的扩展提供对chrome.tabCapture (opens new window) API 的访问权限。
"tabGroups" 让您的扩展访问chrome.tabGroups (opens new window) API。
"tabs" 让您的扩展访问Tab (opens new window)多个 API 使用的对象的特权字段,包括chrome.tabs (opens new window)chrome.windows (opens new window)。在许多情况下,您的扩展不需要声明"tabs"使用这些 API 的权限。
"topSites" 为您的扩展提供对chrome.topSites (opens new window) API 的访问权限。
"tts" 为您的扩展提供对chrome.tts (opens new window) API 的访问权限。
"ttsEngine" 为您的扩展提供对chrome.ttsEngine (opens new window) API 的访问权限。
"unlimitedStorage" 为存储客户端数据(例如数据库和本地存储文件)提供无限配额。如果没有此权限,则扩展限制为 5 MB 的本地存储。**注意:**此权限仅适用于 Web SQL 数据库和应用程序缓存(请参阅问题58985 (opens new window))。此外,它目前不适用于通配符子域,例如http://*.example.com.
"vpnProvider" 让您的扩展访问chrome.vpnProvider (opens new window) API。
"wallpaper" 让您的扩展访问chrome.wallpaper (opens new window) API。
"webNavigation" 为您的扩展提供对chrome.webNavigation (opens new window) API 的访问权限。
"webRequest" 让您的扩展程序访问chrome.webRequest (opens new window) API。
"webRequestBlocking" 如果扩展以阻塞方式使用chrome.webRequest (opens new window) API,则为必需。