PySide6.QtWebEngineQuick.QQuickWebEngineProfile¶

class QQuickWebEngineProfile¶

QQuickWebEngineProfile 类提供了一个由多个页面共享的网页引擎配置文件。更多…

概要¶

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

一个网页引擎配置文件包含设置、脚本、持久性cookie策略以及属于该配置文件的所有网页引擎页面共享的访问链接列表。

关于访问过的链接的信息与持久性cookie和其他持久性数据一起存储在由storageName属性确定的存储中。持久性数据存储在由persistentStoragePath属性确定的子目录中，缓存存储在由cachePath属性确定的子目录中。httpCacheType属性描述了缓存的类型：内存中或磁盘上。如果仅设置了storageName属性，其他值将基于它自动生成。如果您手动指定任何值，应在创建属于配置文件的任何页面之前进行。

配置文件可以用于将页面彼此隔离。一个典型的用例是用于隐私浏览模式的专用无痕配置文件。无痕配置文件强制将cookies、HTTP缓存和其他通常持久化的数据仅存储在内存中。offTheRecord属性用于判断配置文件是否为无痕模式。

默认配置文件可以通过defaultProfile()访问。它是一个内置的配置文件，所有未特别使用其他配置文件创建的网页都属于此配置文件。

可以通过C++中的QQuickWebEngineProfile类创建和访问WebEngineProfile实例，该类在C++中暴露了更多功能。这使得Qt Quick应用程序能够拦截URL请求（QQuickWebEngineProfile::setRequestInterceptor），或者注册自定义URL方案（installUrlSchemeHandler）。

可以通过设置spellCheckEnabled属性来为每个配置文件启用HTML表单字段的拼写检查，并且可以通过使用spellCheckLanguages属性来设置当前用于拼写检查的语言。

class HttpCacheType¶

此枚举描述了HTTP缓存类型：

常量

描述

QQuickWebEngineProfile.MemoryHttpCache

使用内存缓存。如果设置了off-the-record，这是默认设置。

QQuickWebEngineProfile.DiskHttpCache

使用磁盘缓存。如果未设置off-the-record，这是默认设置。如果设置了off-the-record，则回退到MemoryHttpCache。

QQuickWebEngineProfile.NoCache

禁用内存和磁盘缓存。（在Qt 5.7中添加）

常量	描述
QQuickWebEngineProfile.MemoryHttpCache	使用内存缓存。如果设置了`off-the-record`，这是默认设置。
QQuickWebEngineProfile.DiskHttpCache	使用磁盘缓存。如果未设置`off-the-record`，这是默认设置。如果设置了`off-the-record`，则回退到`MemoryHttpCache`。
QQuickWebEngineProfile.NoCache	禁用内存和磁盘缓存。（在Qt 5.7中添加）

class PersistentCookiesPolicy¶

此枚举描述了cookie持久性的策略：

常量

描述

QQuickWebEngineProfile.NoPersistentCookies

会话和持久性cookie都存储在内存中。如果设置了off-the-record或没有可用的持久数据路径，这是唯一可能的设置。

QQuickWebEngineProfile.AllowPersistentCookies

标记为持久的Cookies会被保存到磁盘并从磁盘恢复，而会话Cookies仅存储在磁盘上用于崩溃恢复。这是默认设置。

QQuickWebEngineProfile.ForcePersistentCookies

会话和持久性 cookie 都会保存到磁盘并从磁盘恢复。

常量	描述
QQuickWebEngineProfile.NoPersistentCookies	会话和持久性cookie都存储在内存中。如果设置了`off-the-record`或没有可用的持久数据路径，这是唯一可能的设置。
QQuickWebEngineProfile.AllowPersistentCookies	标记为持久的Cookies会被保存到磁盘并从磁盘恢复，而会话Cookies仅存储在磁盘上用于崩溃恢复。这是默认设置。
QQuickWebEngineProfile.ForcePersistentCookies	会话和持久性 cookie 都会保存到磁盘并从磁盘恢复。

class PersistentPermissionsPolicy¶

此枚举描述了权限持久化的策略：

常量

描述

QQuickWebEngineProfile.PersistentPermissionsPolicy.AskEveryTime

应用程序每次需要权限时都会询问，无论之前是否已经授予过权限。这是为了与现有应用程序向后兼容，否则不推荐使用。

QQuickWebEngineProfile.PersistentPermissionsPolicy.StoreInMemory

只有在第一次需要权限时才会发出请求。任何后续请求将根据初始用户选择自动批准或拒绝。这将延续到所有使用相同QQuickWebEngineProfile实例的页面，直到应用程序关闭。如果设置了off-the-record或没有可用的持久数据路径，则应用此设置。

QQuickWebEngineProfile.PersistentPermissionsPolicy.StoreOnDisk

与PersistentPermissionsInMemory的工作方式相同，但权限会保存到磁盘并从磁盘恢复。这是默认设置。

常量	描述
QQuickWebEngineProfile.PersistentPermissionsPolicy.AskEveryTime	应用程序每次需要权限时都会询问，无论之前是否已经授予过权限。这是为了与现有应用程序向后兼容，否则不推荐使用。
QQuickWebEngineProfile.PersistentPermissionsPolicy.StoreInMemory	只有在第一次需要权限时才会发出请求。任何后续请求将根据初始用户选择自动批准或拒绝。这将延续到所有使用相同`QQuickWebEngineProfile`实例的页面，直到应用程序关闭。如果设置了`off-the-record`或没有可用的持久数据路径，则应用此设置。
QQuickWebEngineProfile.PersistentPermissionsPolicy.StoreOnDisk	与`PersistentPermissionsInMemory`的工作方式相同，但权限会保存到磁盘并从磁盘恢复。这是默认设置。