QNetworkCookie Class
La clase QNetworkCookie almacena una cookie de red. Más información...
| Cabecera: | #include <QNetworkCookie> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
- Lista de todos los miembros, incluidos los miembros heredados
- QNetworkCookie forma parte de las clases compartidas implícitamente.
Tipos públicos
| enum | RawForm { NameAndValueOnly, Full } |
(since 6.1) enum class | SameSite { Default, None, Lax, Strict } |
Funciones públicas
| QNetworkCookie(const QByteArray &name = QByteArray(), const QByteArray &value = QByteArray()) | |
| QNetworkCookie(const QNetworkCookie &other) | |
| ~QNetworkCookie() | |
| QString | domain() const |
| QDateTime | expirationDate() const |
| bool | hasSameIdentifier(const QNetworkCookie &other) const |
| bool | isHttpOnly() const |
| bool | isSecure() const |
| bool | isSessionCookie() const |
| QByteArray | name() const |
| void | normalize(const QUrl &url) |
| QString | path() const |
(since 6.1) QNetworkCookie::SameSite | sameSitePolicy() const |
| void | setDomain(const QString &domain) |
| void | setExpirationDate(const QDateTime &date) |
| void | setHttpOnly(bool enable) |
| void | setName(const QByteArray &cookieName) |
| void | setPath(const QString &path) |
(since 6.1) void | setSameSitePolicy(QNetworkCookie::SameSite sameSite) |
| void | setSecure(bool enable) |
| void | setValue(const QByteArray &value) |
| void | swap(QNetworkCookie &other) |
| QByteArray | toRawForm(QNetworkCookie::RawForm form = Full) const |
| QByteArray | value() const |
| bool | operator!=(const QNetworkCookie &other) const |
| QNetworkCookie & | operator=(const QNetworkCookie &other) |
| bool | operator==(const QNetworkCookie &other) const |
Miembros públicos estáticos
| QList<QNetworkCookie> | parseCookies(QByteArrayView cookieString) |
Descripción detallada
Las cookies son pequeños fragmentos de información que los protocolos sin estado, como HTTP, utilizan para mantener cierta información persistente entre solicitudes.
Un servidor remoto establece una cookie cuando responde a una solicitud y espera que se le devuelva la misma cookie cuando se envíen solicitudes posteriores.
QNetworkCookie almacena una de estas cookies tal y como se recibe de la red. Una cookie tiene un nombre y un valor, pero estos son opacos para la aplicación (es decir, la información almacenada en ellos no tiene significado para la aplicación). Una cookie tiene asociados un nombre de ruta y un dominio, que indican cuándo debe volver a enviarse la cookie al servidor.
Una cookie también puede tener una fecha de caducidad, que indica su validez. Si no hay fecha de caducidad, la cookie se considera una «cookie de sesión» y debe descartarse al salir de la aplicación (o al finalizar su concepto de sesión).
QNetworkCookie ofrece una forma de analizar una cookie a partir del formato de encabezado HTTP mediante la función QNetworkCookie::parseCookies(). Sin embargo, cuando se recibe en un objeto QNetworkReply, la cookie ya está analizada.
Esta clase implementa las cookies tal y como se describen en la especificación inicial de cookies de Netscape, que es en cierto modo similar a la especificación RFC 2109, además de la extensión «HttpOnly». No es compatible con la especificación RFC 2965 más reciente (que utiliza el encabezado Set-Cookie2).
Véase también QNetworkCookieJar, QNetworkRequest y QNetworkReply.
Documentación sobre los tipos de miembros
enum QNetworkCookie::RawForm
Esta enumeración se utiliza con la función ` toRawForm()` para indicar qué tipo de cookie se debe devolver.
| Constante | Valor | Descripción |
|---|---|---|
QNetworkCookie::NameAndValueOnly | 0 | hace que toRawForm() devuelva únicamente la parte «NAME=VALUE» de la cookie, adecuada para reenviarla a un servidor en el encabezado «Cookie:» de una solicitud del cliente. Las cookies múltiples se separan mediante un punto y coma en el campo de encabezado «Cookie:». |
QNetworkCookie::Full | 1 | hace que toRawForm() devuelva el contenido completo de la cookie, adecuado para enviarlo a un cliente en el encabezado «Set-Cookie:» del servidor. |
Ten en cuenta que solo la forma completa de la cookie puede volver a analizarse para obtener su contenido original.
Véanse también toRawForm() y parseCookies().
[since 6.1] enum class QNetworkCookie::SameSite
| Constante | Valor | Descripción |
|---|---|---|
QNetworkCookie::SameSite::Default | 0 | SameSite no está configurado. El navegador puede interpretarlo como «None» o «Lax». |
QNetworkCookie::SameSite::None | 1 | Las cookies se pueden enviar en todos los contextos. Esto solía ser el valor por defecto, pero los navegadores más recientes han establecido «Lax» como valor por defecto y ahora exigirán que la cookie sea segura y que se establezca «SameSite=None». |
QNetworkCookie::SameSite::Lax | 2 | Las cookies se envían en solicitudes de origen propio y en solicitudes GET iniciadas por sitios web de terceros. Este es el valor predeterminado en los navegadores modernos (desde mediados de 2020). |
QNetworkCookie::SameSite::Strict | 3 | Las cookies solo se enviarán en un contexto de origen. |
Esta enumeración se introdujo en Qt 6.1.
Véase también setSameSitePolicy() y sameSitePolicy().
Documentación de funciones de miembro
[explicit] QNetworkCookie::QNetworkCookie(const QByteArray &name = QByteArray(), const QByteArray &value = QByteArray())
Crea un nuevo objeto QNetworkCookie, inicializando el nombre de la cookie como « name » y su valor como « value ».
Una cookie solo es válida si tiene un nombre. Sin embargo, el valor es opaco para la aplicación y el hecho de que esté vacío puede tener importancia para el servidor remoto.
QNetworkCookie::QNetworkCookie(const QNetworkCookie &other)
Crea un nuevo objeto QNetworkCookie copiando el contenido de other.
[noexcept] QNetworkCookie::~QNetworkCookie()
Elimina este objeto « QNetworkCookie ».
QString QNetworkCookie::domain() const
Devuelve el dominio al que está asociada esta cookie. Esto se corresponde con el campo «domain» de la cadena de la cookie.
Ten en cuenta que el dominio aquí puede comenzar por un punto, lo cual no es un nombre de host válido. Sin embargo, significa que esta cookie coincide con todos los nombres de host que terminan con ese nombre de dominio.
Véase también setDomain().
QDateTime QNetworkCookie::expirationDate() const
Devuelve la fecha de caducidad de esta cookie. Si se trata de una cookie de sesión, el valor « QDateTime » devuelto no será válido. Si la fecha es anterior, significa que esta cookie ya ha caducado y no debe volver a enviarse a un servidor remoto.
La fecha de caducidad se corresponde con los parámetros de la entrada «expires» en la cadena de la cookie.
Véase también isSessionCookie() y setExpirationDate().
bool QNetworkCookie::hasSameIdentifier(const QNetworkCookie &other) const
Devuelve « true » si esta cookie tiene la misma tupla de identificador que « other ». La tupla de identificador está compuesta por el nombre, el dominio y la ruta.
Véase también operator==().
bool QNetworkCookie::isHttpOnly() const
Devuelve « true » si el indicador «HttpOnly» está activado para esta cookie.
Una cookie «HttpOnly» solo se establece y se recupera mediante las solicitudes y respuestas de red; es decir, a través del protocolo HTTP. No es accesible desde los scripts que se ejecutan en los navegadores.
Véase también isSecure().
bool QNetworkCookie::isSecure() const
Devuelve « true » si se ha especificado la opción «secure» en la cadena de la cookie; en caso contrario, devuelve «false».
Las cookies seguras pueden contener información privada y no deben reenviarse a través de conexiones sin cifrar.
Véase también setSecure().
bool QNetworkCookie::isSessionCookie() const
Devuelve « true » si esta cookie es una cookie de sesión. Una cookie de sesión es una cookie que no tiene fecha de caducidad, lo que significa que debe eliminarse cuando finalice el concepto de sesión de la aplicación (normalmente, al cerrar la aplicación).
Véase también expirationDate() y setExpirationDate().
QByteArray QNetworkCookie::name() const
Devuelve el nombre de esta cookie. El único campo obligatorio de una cookie es su nombre; sin él, no se considera válida.
Véase también setName() y value().
void QNetworkCookie::normalize(const QUrl &url)
Esta función normaliza la ruta y el dominio de la cookie si estaban vacíos anteriormente. El parámetro « url » se utiliza para determinar el dominio y la ruta correctos.
[static] QList<QNetworkCookie> QNetworkCookie::parseCookies(QByteArrayView cookieString)
Analiza la cadena de la cookie cookieString tal y como se recibe en la respuesta del servidor en el encabezado «Set-Cookie:». Si se produce un error de análisis, esta función devuelve una lista vacía.
Dado que el encabezado HTTP puede establecer más de una cookie al mismo tiempo, esta función devuelve un QList<QNetworkCookie>, uno por cada cookie que se analice.
Nota: En las versiones de Qt anteriores a la 6.7, esta función solo aceptaba QByteArray.
Véase también toRawForm().
QString QNetworkCookie::path() const
Devuelve la ruta asociada a esta cookie. Esto se corresponde con el campo «path» de la cadena de la cookie.
Véase también setPath().
[since 6.1] QNetworkCookie::SameSite QNetworkCookie::sameSitePolicy() const
Devuelve la opción «SameSite » si se especifica en la cadena de la cookie; en caso contrario, devuelve « SameSite::Default ».
Esta función se introdujo en Qt 6.1.
Véase también setSameSitePolicy().
void QNetworkCookie::setDomain(const QString &domain)
Establece el dominio asociado a esta cookie como domain.
Véase también domain().
void QNetworkCookie::setExpirationDate(const QDateTime &date)
Establece la fecha de caducidad de esta cookie en date. Si se establece una fecha de caducidad no válida para esta cookie, se considerará una cookie de sesión.
Véase también isSessionCookie() y expirationDate().
void QNetworkCookie::setHttpOnly(bool enable)
Establece el indicador «HttpOnly» de esta cookie en « enable ».
Véase también isHttpOnly().
void QNetworkCookie::setName(const QByteArray &cookieName)
Establece el nombre de esta cookie como « cookieName ». Ten en cuenta que, si se establece el nombre de una cookie como un « QByteArray » vacío, dicha cookie dejará de ser válida.
Véanse también name() y value().
void QNetworkCookie::setPath(const QString &path)
Establece la ruta asociada a esta cookie como path.
Véase también path().
[since 6.1] void QNetworkCookie::setSameSitePolicy(QNetworkCookie::SameSite sameSite)
Establece la opción «SameSite » de esta cookie en « sameSite ».
Esta función se introdujo en Qt 6.1.
Véase también sameSitePolicy().
void QNetworkCookie::setSecure(bool enable)
Establece el indicador de seguridad de esta cookie en « enable ».
Las cookies seguras pueden contener información privada y no deben reenviarse a través de conexiones no cifradas.
Véase también isSecure().
void QNetworkCookie::setValue(const QByteArray &value)
Establece el valor de esta cookie en value.
Véase también value() y name().
[noexcept] void QNetworkCookie::swap(QNetworkCookie &other)
Cambia esta cookie por other. Esta operación es muy rápida y nunca falla.
QByteArray QNetworkCookie::toRawForm(QNetworkCookie::RawForm form = Full) const
Devuelve la forma sin procesar de este QNetworkCookie. El QByteArray devuelto por esta función es adecuado para un encabezado HTTP, ya sea en una respuesta del servidor (el encabezado Set-Cookie) o en la solicitud del cliente (el encabezado Cookie). Puedes elegir entre dos formatos, utilizando form.
Véase también parseCookies().
QByteArray QNetworkCookie::value() const
Devuelve el valor de esta cookie, tal y como se especifica en la cadena de la cookie. Ten en cuenta que una cookie sigue siendo válida aunque su valor esté vacío.
Los pares nombre-valor de las cookies se consideran opacos para la aplicación: es decir, sus valores no significan nada.
Véase también setValue() y name().
bool QNetworkCookie::operator!=(const QNetworkCookie &other) const
Devuelve « true » si esta cookie no es igual a « other ».
Véase también operator==().
QNetworkCookie &QNetworkCookie::operator=(const QNetworkCookie &other)
Copia el contenido del objeto « QNetworkCookie » other a este objeto.
bool QNetworkCookie::operator==(const QNetworkCookie &other) const
Devuelve « true » si esta cookie es igual a « other ». Esta función solo devuelve « true » si todos los campos de la cookie son iguales.
Sin embargo, en algunos contextos, dos cookies con el mismo nombre podrían considerarse iguales.
Véanse también operator!=() y hasSameIdentifier().
© 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.