如需使用大多数 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 的访问权限。 |
"search" |
向您的扩展程序授予对 chrome.search 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.tabs 和 chrome.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,则必须提供此属性。 |