QWebEngineClientHints Class
QWebEngineClientHints 类提供了一个对象，用于定制配置文件使用的用户代理客户端提示。更多
| Header： | #include <QWebEngineClientHints> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake： | QT += webenginecore |
| 自 | Qt 6.8 |
| 继承： | QObject |
属性
|
|
公共功能
| QString | arch() const |
| QString | bitness() const |
| QString | fullVersion() const |
| QVariantMap | fullVersionList() const |
| bool | isAllClientHintsEnabled() |
| bool | isMobile() const |
| bool | isWow64() const |
| QString | model() const |
| QString | platform() const |
| QString | platformVersion() const |
| void | resetAll() |
| void | setAllClientHintsEnabled(bool enabled) |
| void | setArch(const QString &) |
| void | setBitness(const QString &) |
| void | setFullVersion(const QString &) |
| void | setFullVersionList(const QVariantMap &) |
| void | setIsMobile(bool) |
| void | setIsWow64(bool) |
| void | setModel(const QString &) |
| void | setPlatform(const QString &) |
| void | setPlatformVersion(const QString &) |
详细说明
QWebEngineClientHints 允许通过 User-Agent 响应和请求头以及 JavaScript API 配置浏览器和平台信息。
通过该 API 访问的信息分为两组：低熵提示和高熵提示。低熵提示（platform 和mobile ）是那些不会泄露太多信息的提示；API 可在每次请求中访问这些提示，而且QWebEngineClientHints::setAllClientHintsEnabled 无法禁用这些提示。
所有其他提示都是高熵提示；它们有可能泄露更多信息，因此可以通过QWebEngineClientHints::setAllClientHintsEnabled 禁用。
每个配置文件对象都有自己的 QWebEngineClientHints 对象，用于配置该浏览上下文的客户端提示设置。如果未为网络引擎配置文件配置客户端提示，则会从系统中推导出其默认值。
另请参阅 QWebEngineProfile::clientHints() 和QQuickWebEngineProfile::clientHints()。
属性文档
arch : QString
Sec-CH-UA-Arch HTTP 头信息的值和 JavaScript 中 NavigatorUAData 的architecture 成员。
访问功能：
| QString | arch() const |
| void | setArch(const QString &) |
bitness : QString
Sec-CH-UA-Bitness HTTP 头信息的值和 JavaScript 中 NavigatorUAData 的bitness 成员。
访问功能：
| QString | bitness() const |
| void | setBitness(const QString &) |
fullVersion : QString
Sec-CH-UA-Full-Version HTTP 头信息的值和 JavaScript 中 NavigatorUAData 的uaFullVersion 成员。
访问功能：
| QString | fullVersion() const |
| void | setFullVersion(const QString &) |
fullVersionList : QVariantMap
Sec-CH-UA-Full-Version-List HTTP 头信息的值和 JavaScript 中 NavigatorUAData 的fullVersionList 成员。
它在QVariantMap 中保存品牌名称和版本号对。所提供的值将由当前使用的 Chromium 版本和半随机品牌自动扩展。
访问功能：
| QVariantMap | fullVersionList() const |
| void | setFullVersionList(const QVariantMap &) |
isAllClientHintsEnabled : bool
该属性控制WebEngine 是否发送客户端提示 HTTP 头信息。
默认已启用。
访问功能：
| bool | isAllClientHintsEnabled() |
| void | setAllClientHintsEnabled(bool enabled) |
mobile : bool
Sec-CH-UA-Mobile HTTP 头信息的值和 JavaScript 中 NavigatorUAData 的mobile 成员。
不能禁用。
访问功能：
| bool | isMobile() const |
| void | setIsMobile(bool) |
model : QString
Sec-CH-UA-Model HTTP 头信息的值和 JavaScript 中 NavigatorUAData 的model 成员。
访问功能：
| QString | model() const |
| void | setModel(const QString &) |
platform : QString
Sec-CH-UA-Platform HTTP 头信息的值和 JavaScript 中 NavigatorUAData 的platform 成员。
不能禁用。
访问功能：
| QString | platform() const |
| void | setPlatform(const QString &) |
platformVersion : QString
Sec-CH-UA-Platform-Version HTTP 头信息的值和 JavaScript 中 NavigatorUAData 的platformVersion 成员。
访问功能：
| QString | platformVersion() const |
| void | setPlatformVersion(const QString &) |
wow64 : bool
Sec-CH-UA-Wow64 HTTP 头信息的值和 JavaScript 中 NavigatorUAData 的wow64 成员。
访问函数：
| bool | isWow64() const |
| void | setIsWow64(bool) |
成员函数文档
[invokable] void QWebEngineClientHints::resetAll()
将所有客户端提示设置重置为默认值。
注： 可通过元对象系统和 QML 调用此功能。请参阅Q_INVOKABLE 。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
