QWebEngineClientHints Class
La classe QWebEngineClientHints fournit un objet permettant de personnaliser les indications User-Agent Client utilisées par un profil. Plus d'informations...
| En-tête : | #include <QWebEngineClientHints> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake : | QT += webenginecore |
| Depuis : | Qt 6.8 |
| Hérite : | QObject |
Propriétés
|
|
Fonctions publiques
| 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 &) |
Description détaillée
QWebEngineClientHints permet de configurer l'exposition des informations relatives au navigateur et à la plate-forme via la réponse User-Agent et les en-têtes de requête, ainsi qu'une API JavaScript.
Les informations accessibles via cette API sont réparties en deux groupes : les indices à faible entropie et les indices à forte entropie. Les indices à faible entropie (platform et mobile) sont ceux qui ne donnent pas beaucoup d'informations ; l'API les rend accessibles à chaque demande et ils ne peuvent pas être désactivés par QWebEngineClientHints::setAllClientHintsEnabled.
Tous les autres sont des indices à haute entropie ; ils ont le potentiel de donner plus d'informations et peuvent donc être désactivés par QWebEngineClientHints::setAllClientHintsEnabled.
Chaque objet de profil possède son propre objet QWebEngineClientHints, qui configure les paramètres de l'indice client pour ce contexte de navigation. Si un indice client n'est pas configuré pour un profil de moteur web, sa valeur par défaut est déduite du système.
Voir également QWebEngineProfile::clientHints() et QQuickWebEngineProfile::clientHints().
Documentation sur les propriétés
arch : QString
La valeur de l'en-tête HTTP Sec-CH-UA-Arch et du membre architecture de NavigatorUAData en JavaScript.
Fonctions d'accès :
| QString | arch() const |
| void | setArch(const QString &) |
bitness : QString
La valeur de l'en-tête HTTP Sec-CH-UA-Bitness et du membre bitness de NavigatorUAData en JavaScript.
Fonctions d'accès :
| QString | bitness() const |
| void | setBitness(const QString &) |
formFactors : QStringList
La valeur de l'en-tête de requête HTTP Sec-CH-UA-Form-Factors.
Il donne au serveur des informations sur les facteurs de forme de l'agent utilisateur. Il s'agit d'un en-tête structuré dont la valeur doit être une liste. Les valeurs de l'en-tête sont sensibles à la casse. Pour plus d'informations, voir https://wicg.github.io/ua-client-hints/#sec-ch-ua-form-factors
Fonctions d'accès :
| QStringList | formFactors() const |
| void | setFormFactors(const QStringList &) |
fullVersion : QString
La valeur de l'en-tête HTTP Sec-CH-UA-Full-Version et du membre uaFullVersion de NavigatorUAData en JavaScript.
Fonctions d'accès :
| QString | fullVersion() const |
| void | setFullVersion(const QString &) |
fullVersionList : QVariantMap
La valeur de l'en-tête HTTP Sec-CH-UA-Full-Version-List et le membre fullVersionList de NavigatorUAData en JavaScript.
La valeur de l'en-tête Sec-CH-UA sera également générée en tronquant les numéros de version.
Il contient des paires de noms de marque et de numéros de version dans un fichier QVariantMap. Les valeurs fournies seront automatiquement complétées par la version de Chromium actuellement utilisée et une marque semi-aléatoire.
Fonctions d'accès :
| QVariantMap | fullVersionList() const |
| void | setFullVersionList(const QVariantMap &) |
isAllClientHintsEnabled : bool
Cette propriété détermine si les en-têtes HTTP Client Hints sont envoyés par WebEngine ou non.
Elle est activée par défaut.
Fonctions d'accès :
| bool | isAllClientHintsEnabled() |
| void | setAllClientHintsEnabled(bool enabled) |
mobile : bool
La valeur de l'en-tête HTTP Sec-CH-UA-Mobile et du membre mobile de NavigatorUAData en JavaScript.
Ne peut être désactivé.
Fonctions d'accès :
| bool | isMobile() const |
| void | setIsMobile(bool) |
model : QString
La valeur de l'en-tête HTTP Sec-CH-UA-Model et du membre model de NavigatorUAData en JavaScript.
Fonctions d'accès :
| QString | model() const |
| void | setModel(const QString &) |
platform : QString
La valeur de l'en-tête HTTP Sec-CH-UA-Platform et du membre platform de NavigatorUAData en JavaScript.
Ne peut être désactivé.
Fonctions d'accès :
| QString | platform() const |
| void | setPlatform(const QString &) |
platformVersion : QString
La valeur de l'en-tête HTTP Sec-CH-UA-Platform-Version et du membre platformVersion de NavigatorUAData en JavaScript.
Fonctions d'accès :
| QString | platformVersion() const |
| void | setPlatformVersion(const QString &) |
wow64 : bool
La valeur de l'en-tête HTTP Sec-CH-UA-Wow64 et du membre wow64 de NavigatorUAData en JavaScript.
Fonctions d'accès :
| bool | isWow64() const |
| void | setIsWow64(bool) |
Documentation des fonctions membres
[invokable] void QWebEngineClientHints::resetAll()
Réinitialise tous les paramètres des conseils du client à leurs valeurs par défaut.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
© 2026 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.
