WebEngineProfile QML 类型

包含多个 Web 引擎视图共用的设置、脚本和访问过的链接。 更多...

导入语句import QtWebEngine
自QtWebEngine 1.1
实例化 QQuickWebEngineProfile

属性

信号

方法

详细描述

WebEngineProfile 包含属于该配置文件的所有视图共享的设置、脚本和访问过的链接。

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

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

每个网络引擎视图都有一个相关的配置文件。未设置特定配置文件的视图共享一个公共默认配置文件。

属性说明

cachePath : 字符串

配置文件缓存存储位置的路径，特别是HTTP缓存。

默认情况下，缓存存储在 QStandardPaths::writableLocation(QStandardPaths::CacheLocation) 下方，目录名使用 storageName。


downloadPath : 字符串 [since QtWebEngine 1.9]

下载文件存储位置的路径。

覆盖用于下载位置的默认路径。

如果设置为空字符串，则恢复默认路径。

注意：默认下载路径为 QStandardPaths::DownloadLocation。

此属性是在QtWebEngine 1.9中引入的。


httpAcceptLanguage : 字符串 [since QtWebEngine 1.2]

Accept-Language HTTP请求报头字段的值。

此属性是在QtWebEngine 1.2中引入的。


httpCacheMaximumSize : 整数

HTTP缓存的最高大小。如果设置为 0，大小将由 QtWebEngine 自动控制。默认值为 0。

另请参阅：httpCacheType。


httpCacheType : 枚举

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

常量描述
WebEngineProfile.MemoryHttpCache使用内存缓存。如果设置了 offTheRecord 或没有 storageName，这是唯一可能的设置，默认。
WebEngineProfile.DiskHttpCache使用磁盘缓存。对于非离线配置文件且设置了 storageName 的情况，默认值。
WebEngineProfile.NoCache禁用缓存。（从5.7版开始添加）

httpUserAgent : 字符串

与HTTP一起发送以识别浏览器的用户代理字符串。

注意：在Windows 8.1及更高版本上，除非应用程序包含声明支持较新Windows版本的清单，否则默认用户代理总是会报告 "Windows NT 6.2"（Windows 8）。


isPushServiceEnabled : bool [自 QtWebEngine 6.5 开始]

推送消息服务是否启用。

注意：默认情况下，推送消息服务是禁用的。

注意：Qt WebEngine 使用 Firebase 云消息 (FCM) 作为浏览器推送服务。因此，所有推送消息都将通过 Google 推送服务和其相应的服务器。

此属性是在 QtWebEngine 6.5 中引入的。


offTheRecord : bool

Web 引擎配置文件是否为 离线记录。离线记录配置文件将 cookie、HTTP 缓存和其他通常持久数据仅保存在内存中。默认情况下配置文件为离线记录。


persistentCookiesPolicy : 枚举

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

常量描述
WebEngineProfile.NoPersistentCookies会话和持久 cookie 都保存在内存中。如果 offTheRecord 已设置，或者没有 storageName，则这是唯一可设置的设置，这是默认设置。
WebEngineProfile.AllowPersistentCookies标记为持久的 cookie 存储到和从磁盘恢复，而会话 cookie 仅在崩溃恢复时存储到磁盘。这是带有 storageName 的非离线配置文件的默认值。
WebEngineProfile.ForcePersistentCookies会话和持久 cookie 都保存到和从磁盘恢复。

persistentStoragePath : string

存储浏览器和网页内容的持久数据的存储位置的路径。持久数据包括持久 cookie、HTML5 本地存储和已访问链接。

默认情况下，存储位于 QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) 下方，在名为 storageName 的目录中。


spellCheckEnabled : bool [自 QtWebEngine 1.4 开始]

此属性表示是否启用了 Web 引擎拼写检查器。

此属性是在 QtWebEngine 1.4 中引入的。


spellCheckLanguages : 列表<字符串> [自 QtWebEngine 1.4 开始]

此属性表示拼写检查器使用的语言列表。每种语言应与 .bdic 字典文件的名称匹配。例如，语言 en-US 将加载 en-US.bdic 字典文件。

有关字典文件查找的说明，请参阅 拼写检查器功能文档。

有关如何编译 .bdic 字典的更多信息，请参阅 拼写检查器示例。

此属性是在 QtWebEngine 1.4 中引入的。


storageName : 字符串

用于为每个使用磁盘存储持久数据和缓存的配置文件创建单独子目录的存储名称。

另请参阅 WebEngineProfile::persistentStoragePath 和 WebEngineProfile::cachePath。


userScripts : WebEngineScriptCollection [只读]

返回注入到所有共享此配置文件的所有WebEngineScript对象的集合。


信号文档

[自QtWebEngine 6.7开始] clearHttpCacheCompleted()

当完成clearHttpCache()操作时，将发出此信号。

注意：相应的处理程序是 onClearHttpCacheCompleted。

此信号是在QtWebEngine 6.7中引入的。

另请参阅：clearHttpCache()。


downloadFinished(WebEngineDownloadRequest download)

每当下载停止时（因为成功完成、被取消或中断，例如，因为连接丢失），都会发出此信号。参数download包含已完成的下载实例的状态。

注意：相应的处理程序是 onDownloadFinished。


downloadRequested(WebEngineDownloadRequest download)

每当触发下载时，都会发出此信号。参数download包含下载的状态。必须使用WebEngineDownloadRequest::accept()显式接受下载，否则下载将默认取消。

注意：相应的处理程序是 onDownloadRequested。


[自QtWebEngine 1.9开始] presentNotification(WebEngineNotification notification)

每当有新的用户通知创建时，都会发出此信号。参数notification包含用于查询数据和交互的WebEngineNotification实例。

注意：相应的处理程序是 onPresentNotification。

此信号是在QtWebEngine 1.9中引入的。


方法文档

[自QtWebEngine 1.3开始] void clearHttpCache()

清除配置文件的缓存条目。

注意：请确保在清除操作进行期间不要在配置文件上开始新的导航或任何操作。当clearHttpCacheCompleted()信号通知完成时。

此方法是在QtWebEngine 1.3中引入的。

另请参阅：WebEngineProfile::cachePath和clearHttpCacheCompleted。


© 2024 Qt公司。在此处包含的文档贡献的所有权利属于其各自的所有者。本文件中的文档根据自由软件基金会发布的GNU自由文档许可协议版本1.3的条款许可。Qt以及相应的标志是芬兰以及/或世界其他国家的Qt公司的商标。所有其他商标均为其各自所有者的财产。