声明权限

使用大部分 Chrome。*API 进行声明,您的扩展程序或应用必须在“权限”中声明其 intent字段 清单的某个位置。每项权限可以是已知字符串列表(例如 “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" 允许此扩展程序或应用使用 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 使用的 Tab 对象的特权字段的访问权限 包括 chrome.tabschrome.windows。在 在很多情况下,您的扩展程序无需声明 "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)。