webEnginePermission QML Value Type

该对象用于访问和修改已授予或拒绝授予特定起源 URL 的单个权限的状态。更多

属性

• isValid : bool
• origin : url
• permissionType : enumeration
• state : enumeration

方法

• void deny()
• void grant()
• void isPersistent(WebEnginePermission.PermissionType permissionType)
• void reset()

详细说明

典型的使用模式如下：

1. 网站请求特定功能，触发WebEngineView::permissionRequested 信号；
2. 信号处理器触发提示，询问用户是否同意授予权限；
3. 当用户做出决定后，应用程序调用grant() 或deny() ；

另外，有意修改已授予权限的应用程序可以使用WebEngineProfile::listAllPermissions() 获取与配置文件相关的现有权限列表，或使用WebEngineProfile::queryPermission() 获取特定权限的 webEnginePermission 对象。

origin 属性可用于查询 WebEnginePermission 与哪个起源相关联，而permissionType 属性则描述了相关功能。网站来源是其方案、主机名和端口的组合。权限是按起源授予的；因此，如果网页https://www.example.com:12345/some/page.html 请求一个权限，它将被授予给起源https://www.example.com:12345/ 。

permissionType 枚举描述了 Qt XMLWebEngine 支持的所有权限类型。只有某些权限类型会在浏览会话之间被记住；它们是持久的。非持久权限会在每次网站请求时查询用户。您可以使用静态方法 WebEnginePermission::isPersistent() 在运行时检查权限类型是否是持久的。

持久权限存储在活动的WebEngineProfile 中，其生命周期取决于WebEngineProfile::persistentPermissionsPolicy 的值。默认情况下，已命名的配置文件将权限存储在磁盘上，而未记录的配置文件将权限存储在内存中（并在销毁配置文件时销毁）。存储的权限在下一次网站请求时不会询问用户，而是根据用户最初选择的分辨率自动授予或拒绝。要删除存储的权限，可调用reset() 删除。

另一方面，非持久权限只有在相关的WebEngineView 执行导航到不同的 URL 或被销毁时才能使用。

您可以使用isValid 属性检查 WebEnginePermission 是否处于有效状态。对于无效对象，调用grant(),deny(), 或reset() 将不起任何作用，而调用state 将始终返回 WebEnginePermission::Invalid。

另请参阅 WebEngineView::permissionRequested 、WebEngineProfile::queryPermission() 和WebEngineProfile::listAllPermissions()。

属性文档

方法文档