Chrome 浏览器插件 Manifest.json V3 中权限（Permissions）字段解析

2024-01-16 14:44
文章标签 json 解析 浏览器 插件 权限 chrome v3 manifest permissions

本文主要是介绍Chrome 浏览器插件 Manifest.json V3 中权限（Permissions）字段解析，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

一、权限（Permissions）

再使用拓展程序的 API 时，大多数的时候，需要在 manifest.json 文件中声明 permissions 字段。

一、权限类型

在 V3 版本中可以声明以下类别的权限：

  • permissions：
    • 包含下面 permissions 权限列表中的项；
  • optional_permissions：
    • 由用户在运行时（而不是在安装时）授予；
  • content_scripts.matches：
    • 包含一个或多个匹配模式，可允许内容脚本注入到一个或多个主机中；
  • host_permissions：
    • 包含一个或多个匹配模式，可提供对一个或多个主机的访问权限；
  • optional_host_permissions：
    • 由用户在运行时（而不是在安装时）授予。

如果您的扩展程序遭到恶意软件入侵，设置权限有助于限制对您的扩展程序造成的破坏。在安装之前或运行时，系统会向用户显示一些权限警告，以征求用户同意

二、Manifest.json 示例

{"name": "Permissions Extension","permissions": ["activeTab","contextMenus","storage"],"optional_permissions": ["topSites",],"host_permissions": ["https://www.developer.chrome.com/*"],"optional_host_permissions":["https://*/*","http://*/*"],"manifest_version": 3
}

三、主机权限（Host permissions）

主机权限允许扩展程序与网址的匹配格式进行交互。有些 Chrome API 不仅需要拥有自己的 API 权限，还需要主机权限。

需要主机权限的 API：

  • 从扩展程序 Service Worker 和扩展程序页面发出 fetch() 请求。
  • 使用 chrome.tabs API 读取和查询敏感的标签页属性（网址、标题和 favIconUrl）。
  • 以编程方式注入内容脚本。
  • 使用 chrome.webRequest API 监控和控制网络请求。
  • 使用 chrome.cookies API 访问 Cookie。
  • 使用 chrome.declarativeNetRequest API 重定向和修改请求及响应标头。

四、包含警告的权限

如果扩展程序请求多项权限，并且其中的许多权限会在安装时显示警告，用户会看到警告列表
示例：
警告权限示例
如果扩展程序只显示少量警告或向用户说明权限，用户更有可能信任该扩展程序。请考虑实现可选权限或功能略弱的 API，以避免收到警告。
在 host_permissions 和 content_scripts.matches 字段中添加或更改匹配模式也会触发警告。

1. 权限警告列表

权限说明警告
http://*/*
https://*/*
*://*/*
<all_urls>		对所有主机的访问权限读取和更改在所有网站上的所有数据
https://HostName.com/对 https://HostName.com/ 的访问权限读取和更改在 HostName.com 上的数据
accessibilityFeatures.modify允许此扩展程序修改个别无障碍功能的状态更改无障碍设置
accessibilityFeatures.read允许此扩展程序读取各个无障碍功能状态查看无障碍设置
bookmarks对 chrome.bookmarks API 的访问权限读取和更改书签
clipboardRead如果扩展程序使用 document.execCommand('paste')，则必须提供读取复制和粘贴的数据
clipboardWrite表示该扩展程序使用 document.execCommand('copy') 或 document.execCommand('cut')修改复制和粘贴的数据
contentSettings对 chrome.contentSettings API 的访问权限更改用于控制网站对 Cookie、JavaScript、插件、地理定位、麦克风、摄像头等功能的使用权限的设置。
debugger对 chrome.debugger API 的访问权限访问页面调试程序后端

读取和更改在所有网站上的所有数据
declarativeNetRequest对 chrome.declarativeNetRequest API 的访问权限屏蔽任何网页上的内容
declarativeNetRequestFeedback函数和事件的访问权限，这些函数和事件会返回匹配的声明式规则的相关信息读取浏览记录
desktopCapture对 chrome.desktopCapture API 的访问权限截取屏幕上的内容
downloads对 chrome.downloads API 的访问权限管理下载内容
favicon对 Favicon API 的访问权限读取访问的网站的图标
geolocation允许扩展程序在不提示用户授予权限的情况下使用 HTML5 geolocation API检测实际位置
history对 chrome.history API 的访问权限读取和更改所有已登录设备上的浏览记录
identity.email通过 chrome.identity API 对电子邮件地址的访问权限获取电子邮件地址
management对 chrome.management API 的访问权限管理应用、扩展程序和主题背景
nativeMessaging对 Native Messaging API 的访问权限与协作的原生应用通信
notifications对 chrome.notifications API 的访问权限显示通知
pageCapture对 chrome.pageCapture API 的访问权限读取和更改在所有网站上的所有数据
privacy对 chrome.privacy API 的访问权限更改与隐私相关的设置
proxy对 chrome.proxy API 的访问权限读取和更改在所有网站上的所有数据
readingList对 chrome.readingList API 的访问权限读取和更改阅读清单中的条目
sessions 和 history对 chrome.sessionsAPI 和 chrome.history API 的访问权限读取和更改所有已登录设备上的浏览记录
sessions 和 tabs对 chrome.sessions API 以及 Tab 对象的特权字段的访问权限读取在所有已登录账号设备上的浏览记录
system.storage对 chrome.system.storage API 的访问权限识别和弹出存储设备
tabCapture对 chrome.tabCapture API 的访问权限读取和更改在所有网站上的所有数据
tabGroups对 chrome.tabGroups API 的访问权限查看和管理标签页分组
tabs对多个 API（包括 chrome.tabs 和 chrome.windows）使用的 Tab 对象的特权字段的访问权限读取浏览记录
topSites对 chrome.topSites API 的访问权限读取最常访问的网站列表
ttsEngine对 chrome.ttsEngine API 的访问权限朗读使用合成语音说出的所有文字
webAuthenticationProxy对 chrome.webAuthenticationProxy API 的访问权限读取和更改在所有网站上的所有数据
webNavigation对 chrome.webNavigation API 的访问权限读取浏览记录

五、权限列表

1. accessibilityFeatures.modify

允许扩展程序在使用 chrome.accessibilityFeatures API 时修改无障碍功能状态。

2. accessibilityFeatures.read

允许扩展程序在使用 chrome.accessibilityFeatures API 时读取无障碍功能状态。

3. activeTab

通过用户手势对活动标签页的临时访问权限。

4. alarms

对 chrome.alarms API 的访问权限。

5. audio

对 chrome.audio API 的访问权限。

6. background

让 Chrome 尽早启动（用户登录计算机、启动 Chrome 之前）和延迟关闭（即使最后一个窗口已关闭，直到用户明确退出 Chrome）。

7. bookmarks

对 chrome.bookmarks API 的访问权限。

8. browsingData

对 chrome.browsingData API 的访问权限。

9. certificateProvider

对 chrome.certificateProvider API 的访问权限。

10. contentSettings

对 chrome.contentSettings API 的访问权限。

11. contextMenus

对 chrome.contextMenus API 的访问权限。

12. cookies

对 chrome.cookies API 的访问权限。

13. debugger

对 chrome.debugger API 的访问权限。

14. declarativeContent

对 chrome.declarativeContent API 的访问权限。

15. declarativeNetRequest

对 chrome.declarativeNetRequest API 的访问权限。

16. declarativeNetRequestWithHostAccess

在需要主机权限时对 chrome.declarativeNetRequest API 的访问权限。

17. declarativeNetRequestFeedback

使用 chrome.declarativeNetRequest API 时向开发者工具控制台写入错误和警告的权限。

18. dns

对 chrome.dns API 的访问权限。

19. desktopCapture

对 chrome.desktopCapture API 的访问权限。

20. documentScan

对 chrome.documentScan API 的访问权限。

21. downloads

对 chrome.downloads API 的访问权限。

22. downloads.open

允许使用 chrome.downloads.open()。

23. downloads.ui

允许使用 chrome.downloads.setUiOptions()。

24. enterprise.deviceAttributes

对 chrome.enterprise.deviceAttributes API 的访问权限。

25. enterprise.hardwarePlatform

对 chrome.enterprise.hardwarePlatform API 的访问权限。

26. enterprise.networkingAttributes

对 chrome.enterprise.networkingAttributes API 的访问权限。

27. enterprise.platformKeys

对 chrome.enterprise.platformKeys API 的访问权限。

28. favicon

对 Favicon API 的访问权限。

29. fileBrowserHandler

对 chrome.fileBrowserHandler API 的访问权限。

30. fileSystemProvider

对 chrome.fileSystemProvider API 的访问权限。

31. fontSettings

对 chrome.fontSettings API 的访问权限。

32. gcm

对 chrome.gcm 和 chrome.instanceID API 的访问权限。

33. geolocation

允许扩展程序在不提示用户授予权限的情况下使用 geolocation API。

34. history

对 chrome.history API 的访问权限。

35. identity

对 chrome.identity API 的访问权限。

36. idle

对 chrome.idle API 的访问权限。

37. loginState

对 chrome.loginState API 的访问权限。

38. management

对 chrome.management API 的访问权限。

39. nativeMessaging

对 Native Messaging API 的访问权限。

40. notifications

对 chrome.notifications API 的访问权限。

41. offscreen

对 chrome.offscreen API 的访问权限。

42. pageCapture

对 chrome.pageCapture API 的访问权限。

43. platformKeys

对 chrome.platformKeys API 的访问权限。

44. power

对 chrome.power API 的访问权限。

45. printerProvider

对 chrome.printerProvider API 的访问权限。

46. printing

对 chrome.printing API 的访问权限。

47. printingMetrics

对 chrome.printingMetrics API 的访问权限。

48. privacy

对 chrome.privacy API 的访问权限。

49. processes

对 chrome.processes API 的访问权限。

50. proxy

对 chrome.proxy API 的访问权限。

51. runtime

对 runtime.connectNative() 和 runtime.sendNativeMessage() 的访问权限。对于 runtime 命名空间的所有其他功能，无需任何权限。

52. scripting

对 chrome.scripting API 的访问权限。

53. search

对 chrome.search API 的访问权限。

54. sessions

对 chrome.sessions API 的访问权限。

55. sidePanel

对 chrome.sidePanel API 的访问权限。

56. storage

对 chrome.storage API 的访问权限。

57. system.cpu

对 chrome.system.cpu API 的访问权限。

58. system.display

对 chrome.system.display API 的访问权限。

59. system.memory

对 chrome.system.memory API 的访问权限。

60. system.storage

对 chrome.system.storage API 的访问权限。

61. tabCapture

对 chrome.tabCapture API 的访问权限。

62. tabGroups

对 chrome.tabGroups API 的访问权限。

63. tabs

对多个 API（包括 chrome.tabs 和 chrome.windows）使用的 Tab 对象的特权字段的访问权限。

64. topSites

对 chrome.topSites API 的访问权限。

65. tts

对 chrome.tts API 的访问权限。

66. ttsEngine

对 chrome.ttsEngine API 的访问权限。

67. unlimitedStorage

针对 chrome.storage.local、IndexedDB 提供无限制的配额，
为 chrome.storage.local、IndexedDB、Cache Storage 和 Origin Private File System 提供无限制的配额。

68. vpnProvider

对 chrome.vpnProvider API 的访问权限。

69. wallpaper

对 chrome.wallpaper API 的访问权限。

70. webAuthenticationProxy

对 chrome.webAuthenticationProxy API 的访问权限。

71. webNavigation

对 chrome.webNavigation API 的访问权限。

72. webRequest

对 chrome.webRequest API 的访问权限。

73. webRequestBlocking

允许使用 chrome.webRequest API 进行屏蔽。

六、可选权限

1. 确定必需权限和可选权限

  • 扩展程序可以声明必需权限和可选权限。
    • 如果扩展程序的基本功能需要用到所需权限，请使用这些权限。
    • 如果扩展程序中的可选功能需要用到可选权限，请使用这些权限。
  • 必需权限的优点：
    • 提示更少：扩展程序可以提示用户接受所有权限一次。
    • 开发更简单：必要权限必定存在。
  • 可选权限的优点：
    • 安全性更高：由于用户仅启用所需的权限，因此扩展程序能够以更少的权限运行。
    • 为用户提供更实用的信息：在用户启用相关功能时，扩展程序可以解释为什么它需要特定权限。
    • 升级更轻松：升级扩展程序时，如果升级过程增加了可选权限而非必需权限，Chrome 不会为用户停用该扩展程序。

2. 在 Manifest.json 中声明可选权限

使用 optional_permissions 键在扩展程序清单中声明可选权限，格式与 permissions 字段相同：

{"name": "My extension","optional_permissions": ["tabs"],"optional_host_permissions": ["https://www.google.com/"],
}
2.1 无法指定为可选的权限

大多数 Chrome 扩展程序权限均可指定为可选权限，但以下权限除外。

  • debugger
  • declarativeNetRequest"devtools
  • experimental
  • geolocation
  • mdns
  • proxy
  • tts
  • ttsEngine
  • wallpaper

3. 请求可选权限

示例：
使用 permissions.request() 在 click 中请求权限：

document.querySelector('#my-button').addEventListener('click', (event) => {// Permissions must be requested from inside a user gesture, like a button's// 权限必须从用户手势内部请求，比如按钮// click handler.chrome.permissions.request({permissions: ['tabs'],origins: ['https://www.google.com/']}, (granted) => {// The callback argument will be true if the user granted the permissions.// 如果用户授予权限，则callback参数将为true。if (granted) {doSomething();} else {doSomethingElse();}});
});

4. 检查扩展程序的当前权限

如需检查扩展程序是否具有特定权限或一组权限，请使用 permission.contains()：

chrome.permissions.contains({permissions: ['tabs'],origins: ['https://www.google.com/']
}, (result) => {if (result) {// The extension has the permissions.// 扩展具有相应的权限。} else {// The extension doesn't have the permissions.}
});

5. 移除权限

如果不再需要某些权限，应将其移除。移除权限后，调用 permissions.request() 通常会在不提示用户的情况下重新添加该权限。

chrome.permissions.remove({permissions: ['tabs'],origins: ['https://www.google.com/']
}, (removed) => {if (removed) {// The permissions have been removed.// 权限已被移除。} else {// The permissions have not been removed (e.g., you tried to remove// required permissions).}
});

七、类型（Types）

1. Permissions 属性

1.1 origins
  • string[] 选填
  • 主机权限的列表，包括清单中的 optional_permissions 或 permissions 键中指定的权限，以及与内容脚本相关联的权限。
1.2 permissions
  • string[] 选填
  • 已命名权限（不包括主机或源）的列表。

八、方法（Methods）

1. contains()

检查扩展程序是否具有指定权限。

1.1 示例
chrome.permissions.contains(permissions:Permissions,callback?:function,
)
1.2 参数
  • permissions: Permissions
  • callback: function 可选 (result: boolean) => void
1.3 返回
  • Promise<boolean>
    如果扩展程序具有指定的权限，则为 true。如果将某个来源同时指定为可选权限和内容脚本匹配模式，则返回 false，除非同时授予这两项权限。

2. getAll()

获取扩展程序的当前权限集。

2.1 示例
chrome.permissions.getAll(callback?:function,
)
2.2 参数
  • callback: function 可选 (permissions: Permissions)=>void
2.3 返回
  • Promise<Permissions>
    扩展程序的有效权限。

3. remove()

移除对指定权限的访问权限。

3.1 示例
chrome.permissions.remove(permissions:Permissions,callback?:function,
)
3.2 参数
  • permissions: Permissions
  • callback: function 可选 (removed: boolean)=>void
3.3 返回
  • Promise<boolean>
    如果权限已移除，则为 true。

4. request()

请求访问指定权限，必要时向用户显示提示。这些权限必须在清单的 optional_permissions 字段中定义，或者是用户保留的必需权限。

4.1 示例
chrome.permissions.request(permissions:Permissions,callback?:function,
)
4.2 参数
  • permissions: Permissions
  • callback: function 可选 (granted: boolean)=>void
4.3 返回
  • Promise<boolean>
    如果用户授予了指定的权限，则为 true。

九、事件（Events）

1. onAdded

在扩展程序获取新权限时触发。

1.1 示例
chrome.permissions.onAdded.addListener(callback:function,
)
1.2 参数
  • callback: function
(permissions:  Permissions)=>void

2. onRemoved

在移除扩展程序的权限时触发。

2.1 参数
  • callback: function
(permissions:  Permissions)=>void

引用

  • 【permissions】
  • 【declare-permissions】

这篇关于Chrome 浏览器插件 Manifest.json V3 中权限（Permissions）字段解析的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/612930。

相关文章

Android 悬浮窗开发示例((动态权限请求 | 前台服务和通知 | 悬浮窗创建 )

Android 悬浮窗开发示例((动态权限请求 | 前台服务和通知 | 悬浮窗创建 )

《Android悬浮窗开发示例((动态权限请求|前台服务和通知|悬浮窗创建)》本文介绍了Android悬浮窗的实现效果,包括动态权限请求、前台服务和通知的使用,悬浮窗权限需要动态申请并引导... 目录一、悬浮窗 动态权限请求1、动态请求权限2、悬浮窗权限说明3、检查动态权限4、申请动态权限5、权限设置完毕后
阅读更多...
浅析如何使用Swagger生成带权限控制的API文档

浅析如何使用Swagger生成带权限控制的API文档

《浅析如何使用Swagger生成带权限控制的API文档》当涉及到权限控制时,如何生成既安全又详细的API文档就成了一个关键问题,所以这篇文章小编就来和大家好好聊聊如何用Swagger来生成带有... 目录准备工作配置 Swagger权限控制给 API 加上权限注解查看文档注意事项在咱们的开发工作里，API
阅读更多...
JavaWeb-WebSocket浏览器服务器双向通信方式

JavaWeb-WebSocket浏览器服务器双向通信方式

《JavaWeb-WebSocket浏览器服务器双向通信方式》文章介绍了WebSocket协议的工作原理和应用场景,包括与HTTP的对比,接着,详细介绍了如何在Java中使用WebSocket,包括配... 目录一、概述二、入门2.1 POM依赖2.2 编写配置类2.3 编写WebSocket服务2.4 浏
阅读更多...
轻松上手MYSQL之JSON函数实现高效数据查询与操作

轻松上手MYSQL之JSON函数实现高效数据查询与操作

《轻松上手MYSQL之JSON函数实现高效数据查询与操作》：本文主要介绍轻松上手MYSQL之JSON函数实现高效数据查询与操作的相关资料,MySQL提供了多个JSON函数,用于处理和查询JSON数... 目录一、jsON_EXTRACT 提取指定数据二、JSON_UNQUOTE 取消双引号三、JSON_KE
阅读更多...
MySQL数据库函数之JSON_EXTRACT示例代码

MySQL数据库函数之JSON_EXTRACT示例代码

《MySQL数据库函数之JSON_EXTRACT示例代码》：本文主要介绍MySQL数据库函数之JSON_EXTRACT的相关资料,JSON_EXTRACT()函数用于从JSON文档中提取值,支持对... 目录前言基本语法路径表达式示例示例 1: 提取简单值示例 2: 提取嵌套值示例 3: 提取数组中的值注意
阅读更多...
C语言中自动与强制转换全解析

C语言中自动与强制转换全解析

《C语言中自动与强制转换全解析》在编写C程序时,类型转换是确保数据正确性和一致性的关键环节,无论是隐式转换还是显式转换,都各有特点和应用场景,本文将详细探讨C语言中的类型转换机制,帮助您更好地理解并在... 目录类型转换的重要性自动类型转换（隐式转换）强制类型转换（显式转换）常见错误与注意事项总结与建议类型
阅读更多...
SpringBoot定制JSON响应数据的实现

SpringBoot定制JSON响应数据的实现

《SpringBoot定制JSON响应数据的实现》本文主要介绍了SpringBoot定制JSON响应数据的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们... 目录前言一、如何使用@jsonView这个注解？二、应用场景三、实战案例注解方式编程方式总结 前言
阅读更多...
MySQL 缓存机制与架构解析(最新推荐)

MySQL 缓存机制与架构解析(最新推荐)

《MySQL缓存机制与架构解析(最新推荐)》本文详细介绍了MySQL的缓存机制和整体架构,包括一级缓存（InnoDBBufferPool）和二级缓存（QueryCache）,文章还探讨了SQL... 目录一、mysql缓存机制概述二、MySQL整体架构三、SQL查询执行全流程四、MySQL 8.0为何移除查
阅读更多...
在Rust中要用Struct和Enum组织数据的原因解析

在Rust中要用Struct和Enum组织数据的原因解析

《在Rust中要用Struct和Enum组织数据的原因解析》在Rust中,Struct和Enum是组织数据的核心工具,Struct用于将相关字段封装为单一实体,便于管理和扩展,Enum用于明确定义所有... 目录为什么在Rust中要用Struct和Enum组织数据？一、使用struct组织数据：将相关字段绑
阅读更多...
使用Java实现一个解析CURL脚本小工具

使用Java实现一个解析CURL脚本小工具

《使用Java实现一个解析CURL脚本小工具》文章介绍了如何使用Java实现一个解析CURL脚本的工具,该工具可以将CURL脚本中的Header解析为KVMap结构,获取URL路径、请求类型,解析UR... 目录使用示例实现原理具体实现CurlParserUtilCurlEntityICurlHandler
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2