QWebEngineClientHints Class
La clase QWebEngineClientHints proporciona un objeto para personalizar los User-Agent Client Hints utilizados por un perfil. Más...
| Cabecera: | #include <QWebEngineClientHints> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| Desde: | Qt 6.8 |
| Hereda: | QObject |
Propiedades
|
|
Funciones públicas
| 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 &) |
Descripción Detallada
QWebEngineClientHints permite configurar la exposición de información del navegador y la plataforma a través de las cabeceras de respuesta y petición User-Agent, y una API JavaScript.
La información a la que se accede a través de esta API se divide en dos grupos: pistas de baja entropía y pistas de alta entropía. Las pistas de baja entropía (platform y mobile) son aquellas que no revelan mucha información; la API las hace accesibles con cada petición y no pueden desactivarse mediante QWebEngineClientHints::setAllClientHintsEnabled.
Todas las demás son pistas de alta entropía; tienen el potencial de revelar más información, por lo que pueden desactivarse en QWebEngineClientHints::setAllClientHintsEnabled.
Cada objeto de perfil tiene su propio objeto QWebEngineClientHints, que configura los ajustes de Client Hint para ese contexto de navegación. Si un Client Hint no está configurado para un perfil de motor web, su valor por defecto se deduce del sistema.
Véase también QWebEngineProfile::clientHints() y QQuickWebEngineProfile::clientHints().
Documentación de propiedades
arch : QString
El valor de la cabecera HTTP Sec-CH-UA-Arch y el miembro architecture de NavigatorUAData en JavaScript.
Funciones de acceso:
| QString | arch() const |
| void | setArch(const QString &) |
bitness : QString
El valor de la cabecera HTTP Sec-CH-UA-Bitness y el miembro bitness de NavigatorUAData en JavaScript.
Funciones de acceso:
| QString | bitness() const |
| void | setBitness(const QString &) |
formFactors : QStringList
El valor de la cabecera de petición HTTP Sec-CH-UA-Form-Factors.
Proporciona al servidor información sobre los factores de forma del agente de usuario. Es una cabecera estructurada cuyo valor debe ser una lista. Los valores de la cabecera distinguen entre mayúsculas y minúsculas. Para más información, consulte https://wicg.github.io/ua-client-hints/#sec-ch-ua-form-factors
Funciones de acceso:
| QStringList | formFactors() const |
| void | setFormFactors(const QStringList &) |
fullVersion : QString
El valor de la cabecera HTTP Sec-CH-UA-Full-Version y el miembro uaFullVersion de NavigatorUAData en JavaScript.
Funciones de acceso:
| QString | fullVersion() const |
| void | setFullVersion(const QString &) |
fullVersionList : QVariantMap
El valor de la cabecera HTTP Sec-CH-UA-Full-Version-List y el miembro fullVersionList de NavigatorUAData en JavaScript.
El valor del encabezado Sec-CH-UA también se generará a partir de éste truncando los números de versión.
Contiene pares de nombre de marca y número de versión en un QVariantMap. Los valores proporcionados se ampliarán automáticamente con la versión de Chromium utilizada en ese momento y una marca semialeatoria.
Funciones de acceso:
| QVariantMap | fullVersionList() const |
| void | setFullVersionList(const QVariantMap &) |
isAllClientHintsEnabled : bool
Esta propiedad controla si las cabeceras HTTP Client Hints son enviadas por WebEngine o no.
Habilitada por defecto.
Funciones de acceso:
| bool | isAllClientHintsEnabled() |
| void | setAllClientHintsEnabled(bool enabled) |
mobile : bool
El valor de la cabecera HTTP Sec-CH-UA-Mobile y el miembro mobile de NavigatorUAData en JavaScript.
No puede desactivarse.
Funciones de acceso:
| bool | isMobile() const |
| void | setIsMobile(bool) |
model : QString
El valor de la cabecera HTTP Sec-CH-UA-Model y el miembro model de NavigatorUAData en JavaScript.
Funciones de acceso:
| QString | model() const |
| void | setModel(const QString &) |
platform : QString
El valor de la cabecera HTTP Sec-CH-UA-Platform y el miembro platform de NavigatorUAData en JavaScript.
No puede desactivarse.
Funciones de acceso:
| QString | platform() const |
| void | setPlatform(const QString &) |
platformVersion : QString
El valor de la cabecera HTTP Sec-CH-UA-Platform-Version y el miembro platformVersion de NavigatorUAData en JavaScript.
Funciones de acceso:
| QString | platformVersion() const |
| void | setPlatformVersion(const QString &) |
wow64 : bool
El valor de la cabecera HTTP Sec-CH-UA-Wow64 y el miembro wow64 de NavigatorUAData en JavaScript.
Funciones de acceso:
| bool | isWow64() const |
| void | setIsWow64(bool) |
Documentación de funciones miembro
[invokable] void QWebEngineClientHints::resetAll()
Restablece todos los ajustes de Sugerencias del Cliente a sus valores por defecto.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase 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.
