声明权限

如需使用大多数 Chrome 功能,请使用 Chrome*。API,您的扩展程序或应用必须在manifest的“权限”字段中声明其 intent。每项权限可以是一系列已知字符串(例如“地理位置”)中的某一个字符串,也可以是会授权访问一个或多个主机的匹配模式。如果您的扩展程序或应用遭到恶意软件入侵,权限有助于限制损害。在安装前,系统还会向用户显示某些权限,如权限警告中所详述。

如果某个 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 中事件和方法的访问权限,该 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(包括 chrome.tabschrome.windows)使用的 Tab 对象的特权字段的访问权限。在许多情况下,您的扩展程序无需声明 "tabs" 权限即可使用这些 API。
"topSites" 向您的扩展程序授予对 chrome.topSites API 的访问权限。
"tts" 向您的扩展程序授予对 chrome.tts API 的访问权限。
"ttsEngine" 向您的扩展程序授予对 chrome.ttsEngine API 的访问权限。
"unlimitedStorage" 提供无限配额来存储客户端数据,例如数据库和本地存储文件。 如果没有此权限,扩展程序或应用的本地存储空间将限制为 5 MB。
注意:此权限仅适用于 Web 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,则必须提供此属性。