QWebEngineClientHints Class

The QWebEngineClientHints class provides an object to customize User-Agent Client Hints used by a profile. More...

Header: #include <QWebEngineClientHints>
CMake: find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake: QT += webenginecore
Since: Qt 6.8
Inherits: QObject

Properties

Public Functions

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 &)

Detailed Description

QWebEngineClientHints allows configuration of exposing browser and platform information via User-Agent response and request headers, and a JavaScript API.

The information accessed via this API is split into two groups: low entropy and high entropy hints. Low entropy hints (platform and mobile) are those that do not give away much information; the API makes these accessible with every request and they can not be disabled by QWebEngineClientHints::setAllClientHintsEnabled.

All the others are high entropy hints; they have the potential to give away more information, therefore they can be disabled by QWebEngineClientHints::setAllClientHintsEnabled.

Each profile object has its own QWebEngineClientHints object, which configures the Client Hint settings for that browsing context. If a Client Hint is not configured for a web engine profile, its default value is deduced from the system.

See also QWebEngineProfile::clientHints() and QQuickWebEngineProfile::clientHints().

Property Documentation

arch : QString

The value of the Sec-CH-UA-Arch HTTP header and architecture member of NavigatorUAData in JavaScript.

Access functions:

QString arch() const
void setArch(const QString &)

bitness : QString

The value of the Sec-CH-UA-Bitness HTTP header and bitness member of NavigatorUAData in JavaScript.

Access functions:

QString bitness() const
void setBitness(const QString &)

fullVersion : QString

The value of the Sec-CH-UA-Full-Version HTTP header and uaFullVersion member of NavigatorUAData in JavaScript.

Access functions:

QString fullVersion() const
void setFullVersion(const QString &)

fullVersionList : QVariantMap

The value of the Sec-CH-UA-Full-Version-List HTTP header and fullVersionList member of NavigatorUAData in JavaScript.

It holds brand name and version number pairs in a QVariantMap. The provided values will be automatically extended by the currently used version of Chromium and a semi-random brand.

Access functions:

QVariantMap fullVersionList() const
void setFullVersionList(const QVariantMap &)

isAllClientHintsEnabled : bool

This property controls whether the Client Hints HTTP headers are sent by WebEngine or not.

Enabled by default.

Access functions:

bool isAllClientHintsEnabled()
void setAllClientHintsEnabled(bool enabled)

mobile : bool

The value of the Sec-CH-UA-Mobile HTTP header and mobile member of NavigatorUAData in JavaScript.

Can not be disabled.

Access functions:

bool isMobile() const
void setIsMobile(bool)

model : QString

The value of the Sec-CH-UA-Model HTTP header and model member of NavigatorUAData in JavaScript.

Access functions:

QString model() const
void setModel(const QString &)

platform : QString

The value of the Sec-CH-UA-Platform HTTP header and platform member of NavigatorUAData in JavaScript.

Can not be disabled.

Access functions:

QString platform() const
void setPlatform(const QString &)

platformVersion : QString

The value of the Sec-CH-UA-Platform-Version HTTP header and platformVersion member of NavigatorUAData in JavaScript.

Access functions:

QString platformVersion() const
void setPlatformVersion(const QString &)

wow64 : bool

The value of the Sec-CH-UA-Wow64 HTTP header and wow64 member of NavigatorUAData in JavaScript.

Access functions:

bool isWow64() const
void setIsWow64(bool)

Member Function Documentation

[invokable] void QWebEngineClientHints::resetAll()

Resets all Client Hints settings to their default values.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

© 2024 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.