# 权限声明
扩展可以请求三类权限,使用清单中的相应键指定:
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,则为必需。 |