QWebEngineCookieStore Class
La clase QWebEngineCookieStore proporciona acceso a las cookies de Chromium. Más...
| Cabecera: | #include <QWebEngineCookieStore> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| Hereda: | QObject |
Tipos Públicos
| struct | FilterRequest |
Funciones Públicas
| virtual | ~QWebEngineCookieStore() |
| void | deleteAllCookies() |
| void | deleteCookie(const QNetworkCookie &cookie, const QUrl &origin = QUrl()) |
| void | deleteSessionCookies() |
| void | loadAllCookies() |
| void | setCookie(const QNetworkCookie &cookie, const QUrl &origin = QUrl()) |
| void | setCookieFilter(const std::function<bool (const FilterRequest &)> &filterCallback) |
| void | setCookieFilter(std::function<bool (const FilterRequest &)> &&filterCallback) |
Señales
| void | cookieAdded(const QNetworkCookie &cookie) |
| void | cookieRemoved(const QNetworkCookie &cookie) |
Descripción detallada
La clase permite acceder a las cookies HTTP de Chromium para un perfil específico. Puede utilizarse para sincronizar las cookies de Chromium y de QNetworkAccessManager, así como para establecer, borrar e interceptar cookies durante la navegación. Dado que las operaciones con cookies son asíncronas, el usuario puede optar por proporcionar una función callback para ser notificado del éxito de la operación. Los manejadores de señales para eliminar y añadir no deben utilizarse para ejecutar tareas pesadas, ya que podrían bloquear el hilo IO en caso de una conexión bloqueante.
Utilice QWebEngineProfile::cookieStore() y QQuickWebEngineProfile::cookieStore() para acceder al objeto almacén de cookies de un perfil específico.
Documentación de las funciones miembro
[virtual noexcept] QWebEngineCookieStore::~QWebEngineCookieStore()
Destruye este objeto QWebEngineCookieStore.
[signal] void QWebEngineCookieStore::cookieAdded(const QNetworkCookie &cookie)
Esta señal se emite cada vez que se añade una nueva cookie al almacén de cookies.
[signal] void QWebEngineCookieStore::cookieRemoved(const QNetworkCookie &cookie)
Esta señal se emite cada vez que se elimina una cookie del almacén de cookies.
void QWebEngineCookieStore::deleteAllCookies()
Elimina todas las cookies del almacén de cookies.
Nota: Esta operación es asíncrona.
Véase también loadAllCookies().
void QWebEngineCookieStore::deleteCookie(const QNetworkCookie &cookie, const QUrl &origin = QUrl())
Elimina cookie del almacén de cookies. Es posible proporcionar un argumento opcional origin URL para limitar el alcance de la cookie que se va a eliminar.
Nota: Esta operación es asíncrona.
void QWebEngineCookieStore::deleteSessionCookies()
Elimina todas las cookies de sesión del almacén de cookies. Las cookies de sesión no tienen asignada una fecha de caducidad.
Nota: Esta operación es asíncrona.
Véase también loadAllCookies().
void QWebEngineCookieStore::loadAllCookies()
Carga todas las cookies en el almacén de cookies. La señal cookieAdded() se emite en cada cookie cargada. Las cookies se cargan automáticamente cuando se inicializa el almacén, lo que en la mayoría de los casos ocurre al cargar la primera URL. Sin embargo, llamar a esta función es útil si las cookies deben ser listadas antes de entrar en el contenido de la web.
Nota: Esta operación es asíncrona.
void QWebEngineCookieStore::setCookie(const QNetworkCookie &cookie, const QUrl &origin = QUrl())
Añade cookie al almacén de cookies.
Nota: Si cookie especifica un QNetworkCookie::domain() que no comienza con un punto, se añade automáticamente un punto. Para limitar la cookie al servidor exacto, omita QNetworkCookie::domain() y establezca origin en su lugar.
La URL proporcionada también debe incluir el esquema.
Nota: Esta operación es asíncrona.
void QWebEngineCookieStore::setCookieFilter(const std::function<bool (const FilterRequest &)> &filterCallback)
Instala un filtro de cookies que puede evitar que los sitios y recursos utilicen cookies. El filterCallback debe ser un lambda o functor que tome una estructura FilterRequest. Si se acepta el acceso a la cookie, la función de filtro debe devolver true; en caso contrario, debe devolver false.
El siguiente fragmento de código ilustra cómo establecer un filtro de cookies:
profile->cookieStore()->setCookieFilter( [&allowThirdPartyCookies](const QWebEngineCookieStore::FilterRequest &request) { return !request.thirdParty || allowThirdPartyCookies; } );
Puede desactivar el filtro con un argumento nullptr.
La llamada de retorno no debe utilizarse para ejecutar tareas pesadas ya que se ejecuta en el hilo IO y por lo tanto bloquea la red de Chromium.
Nota: El filtro de cookies también controla otras características con capacidades de rastreo similares a las de las cookies; incluyendo IndexedDB, almacenamiento DOM, API del sistema de archivos, service workers y AppCache.
Véase también deleteAllCookies() y loadAllCookies().
void QWebEngineCookieStore::setCookieFilter(std::function<bool (const FilterRequest &)> &&filterCallback)
Se trata de una función sobrecargada.
© 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.
