QNetworkCookie Class

Documentación de la función miembro

[explicit] QNetworkCookie::QNetworkCookie(const QByteArray &name = QByteArray(), const QByteArray &value = QByteArray())

Crea un nuevo objeto QNetworkCookie, inicializando el nombre de la cookie a name y su valor a value.

Una cookie sólo es válida si tiene un nombre. Sin embargo, el valor es opaco para la aplicación y estar vacío puede tener significado para el servidor remoto.

QNetworkCookie::QNetworkCookie(const QNetworkCookie &other)

Crea un nuevo objeto QNetworkCookie copiando el contenido de other.

[noexcept] QNetworkCookie::~QNetworkCookie()

Destruye este objeto QNetworkCookie.

QString QNetworkCookie::domain() const

Devuelve el dominio al que está asociada esta cookie. Esto corresponde al campo "dominio" de la cadena de la cookie.

Tenga en cuenta que el dominio puede empezar por un punto, que 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 esta cookie es una cookie de sesión, la QDateTime devuelta no será válida. Si la fecha está en el pasado, esta cookie ya ha caducado y no debe enviarse de nuevo a un servidor remoto.

La fecha de caducidad corresponde a los parámetros de la entrada "expires" de la cadena de cookies.

Véase también isSessionCookie() y setExpirationDate().

bool QNetworkCookie::hasSameIdentifier(const QNetworkCookie &other) const

Devuelve true si esta cookie tiene la misma tupla identificadora que other. La tupla identificadora está compuesta por el nombre, el dominio y la ruta.

Véase también operator==().

bool QNetworkCookie::isHttpOnly() const

Devuelve true si la bandera "HttpOnly" está habilitada para esta cookie.

Una cookie que es "HttpOnly" sólo es establecida y recuperada por las peticiones y respuestas de la red; es decir, el 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 especificó la opción "secure" en la cadena de la cookie, false en caso contrario.

Las cookies seguras pueden contener información privada y no deben reenviarse a través de conexiones no cifradas.

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 ser descartada cuando el concepto de sesión de la aplicación termina (normalmente, cuando la aplicación sale).

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 el cual 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 antes estaban vacíos. 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 cookies cookieString recibida de la respuesta del servidor en la cabecera "Set-Cookie:". Si hay un error de análisis, esta función devuelve una lista vacía.

Dado que la cabecera HTTP puede establecer más de una cookie al mismo tiempo, esta función devuelve un QList<QNetworkCookie>, uno por cada cookie analizada.

Véase también toRawForm().

QString QNetworkCookie::path() const

Devuelve la ruta asociada a esta cookie. Corresponde al 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 cookies, SameSite::Default si no está presente.

Esta función se introdujo en Qt 6.1.

Véase también setSameSitePolicy().

void QNetworkCookie::setDomain(const QString &domain)

Establece que el dominio asociado a esta cookie sea domain.

Véase también domain().

void QNetworkCookie::setExpirationDate(const QDateTime &date)

Establece la fecha de expiración de esta cookie en date. Establecer una fecha de expiración inválida a esta cookie significará que es 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 en cookieName. Tenga en cuenta que si el nombre de la cookie es un QByteArray vacío, la cookie no será válida.

Véase también name() y value().

void QNetworkCookie::setPath(const QString &path)

Establece que la ruta asociada a esta cookie sea path.

Véase también path().

[since 6.1] void QNetworkCookie::setSameSitePolicy(QNetworkCookie::SameSite sameSite)

Establece la opción "SameSite" de esta cookie a 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 bruta de este QNetworkCookie. El QByteArray devuelto por esta función es adecuado para una cabecera HTTP, ya sea en una respuesta del servidor (la cabecera Set-Cookie) o en la petición del cliente (la cabecera Cookie). Puede elegir uno de los 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. Tenga en cuenta que una cookie sigue siendo válida si su valor está vacío.

Los pares nombre-valor de cookie 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 sólo 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éase también operator!=() y hasSameIdentifier().