QWebEngineClientHints Class
Die Klasse QWebEngineClientHints stellt ein Objekt zur Verfügung, mit dem die von einem Profil verwendeten User-Agent-Client-Hinweise angepasst werden können. Mehr...
| Kopfzeile: | #include <QWebEngineClientHints> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| Seit: | Qt 6.8 |
| Vererbt: | QObject |
Eigenschaften
|
|
Öffentliche Funktionen
| QString | arch() const |
| QString | bitness() const |
| QStringList | formFactors() 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 | setFormFactors(const QStringList &) |
| 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 &) |
Detaillierte Beschreibung
QWebEngineClientHints ermöglicht die Konfiguration von Browser- und Plattforminformationen über User-Agent-Antwort- und Anfrage-Header und eine JavaScript-API.
Die Informationen, auf die über diese API zugegriffen wird, werden in zwei Gruppen unterteilt: Hinweise mit geringer Entropie und Hinweise mit hoher Entropie. Hinweise mit geringer Entropie (platform und mobile) sind solche, die nicht viele Informationen preisgeben; die API macht diese bei jeder Anfrage zugänglich und sie können nicht durch QWebEngineClientHints::setAllClientHintsEnabled deaktiviert werden.
Alle anderen sind Hinweise mit hoher Entropie; sie haben das Potenzial, mehr Informationen preiszugeben, und können daher durch QWebEngineClientHints::setAllClientHintsEnabled deaktiviert werden.
Jedes Profilobjekt hat sein eigenes QWebEngineClientHints-Objekt, das die Client-Hint-Einstellungen für diesen Browsing-Kontext konfiguriert. Wenn ein Client Hint nicht für ein Web-Engine-Profil konfiguriert ist, wird sein Standardwert vom System abgeleitet.
Siehe auch QWebEngineProfile::clientHints() und QQuickWebEngineProfile::clientHints().
Dokumentation der Eigenschaft
arch : QString
Der Wert des Sec-CH-UA-Arch HTTP-Headers und architecture Member von NavigatorUAData in JavaScript.
Zugriffsfunktionen:
| QString | arch() const |
| void | setArch(const QString &) |
bitness : QString
Der Wert des Sec-CH-UA-Bitness HTTP-Headers und bitness Member von NavigatorUAData in JavaScript.
Zugriffsfunktionen:
| QString | bitness() const |
| void | setBitness(const QString &) |
formFactors : QStringList
Der Wert des Sec-CH-UA-Form-Factors HTTP Request Headers.
Er gibt einem Server Informationen über die Formfaktoren des Benutzeragenten. Es handelt sich um eine strukturierte Kopfzeile, deren Wert eine Liste sein muss. Bei den Werten des Headers wird zwischen Groß- und Kleinschreibung unterschieden. Für weitere Informationen siehe https://wicg.github.io/ua-client-hints/#sec-ch-ua-form-factors
Zugriffsfunktionen:
| QStringList | formFactors() const |
| void | setFormFactors(const QStringList &) |
fullVersion : QString
Der Wert des Sec-CH-UA-Full-Version HTTP-Headers und uaFullVersion Member von NavigatorUAData in JavaScript.
Zugriffsfunktionen:
| QString | fullVersion() const |
| void | setFullVersion(const QString &) |
fullVersionList : QVariantMap
Der Wert des Sec-CH-UA-Full-Version-List HTTP-Headers und fullVersionList Member von NavigatorUAData in JavaScript.
Der Wert des Sec-CH-UA-Headers wird ebenfalls daraus generiert, indem die Versionsnummern abgeschnitten werden.
Er enthält Paare von Markennamen und Versionsnummern in einer QVariantMap. Die bereitgestellten Werte werden automatisch um die aktuell verwendete Version von Chromium und eine semi-zufällige Marke erweitert.
Zugriffsfunktionen:
| QVariantMap | fullVersionList() const |
| void | setFullVersionList(const QVariantMap &) |
isAllClientHintsEnabled : bool
Diese Eigenschaft steuert, ob die Client Hints HTTP-Header von WebEngine gesendet werden oder nicht.
Standardmäßig ist sie aktiviert.
Zugriffsfunktionen:
| bool | isAllClientHintsEnabled() |
| void | setAllClientHintsEnabled(bool enabled) |
mobile : bool
Der Wert des Sec-CH-UA-Mobile HTTP-Headers und mobile Mitglieds von NavigatorUAData in JavaScript.
Kann nicht deaktiviert werden.
Zugriffsfunktionen:
| bool | isMobile() const |
| void | setIsMobile(bool) |
model : QString
Der Wert des Sec-CH-UA-Model HTTP-Headers und model Member von NavigatorUAData in JavaScript.
Zugriffsfunktionen:
| QString | model() const |
| void | setModel(const QString &) |
platform : QString
Der Wert des Sec-CH-UA-Platform HTTP-Headers und platform Mitglieds von NavigatorUAData in JavaScript.
Kann nicht deaktiviert werden.
Zugriffsfunktionen:
| QString | platform() const |
| void | setPlatform(const QString &) |
platformVersion : QString
Der Wert des Sec-CH-UA-Platform-Version HTTP-Headers und platformVersion Member von NavigatorUAData in JavaScript.
Zugriffsfunktionen:
| QString | platformVersion() const |
| void | setPlatformVersion(const QString &) |
wow64 : bool
Der Wert des Sec-CH-UA-Wow64 HTTP-Headers und wow64 Member von NavigatorUAData in JavaScript.
Zugriffsfunktionen:
| bool | isWow64() const |
| void | setIsWow64(bool) |
Dokumentation der Mitgliedsfunktionen
[invokable] void QWebEngineClientHints::resetAll()
Setzt alle Einstellungen für Client-Hinweise auf ihre Standardwerte zurück.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe 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.
