QNetworkCookie Class

Documentation des fonctions membres

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

Créer un nouvel objet QNetworkCookie, en initialisant le nom du cookie à name et sa valeur à value.

Un cookie n'est valide que s'il a un nom. Cependant, la valeur est opaque pour l'application et le fait qu'elle soit vide peut avoir une signification pour le serveur distant.

QNetworkCookie::QNetworkCookie(const QNetworkCookie &other)

Crée un nouvel objet QNetworkCookie en copiant le contenu de other.

[noexcept] QNetworkCookie::~QNetworkCookie()

Détruit cet objet QNetworkCookie.

QString QNetworkCookie::domain() const

Renvoie le domaine auquel ce cookie est associé. Cela correspond au champ "domain" de la chaîne du cookie.

Notez que le domaine peut commencer par un point, ce qui n'est pas un nom d'hôte valide. Cependant, cela signifie que ce cookie correspond à tous les noms d'hôtes se terminant par ce nom de domaine.

Voir aussi setDomain().

QDateTime QNetworkCookie::expirationDate() const

Renvoie la date d'expiration de ce cookie. Si ce cookie est un cookie de session, l'adresse QDateTime renvoyée ne sera pas valide. Si la date est passée, ce cookie a déjà expiré et ne doit pas être renvoyé à un serveur distant.

La date d'expiration correspond aux paramètres de l'entrée "expires" dans la chaîne du cookie.

Voir également isSessionCookie() et setExpirationDate().

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

Renvoie true si ce cookie a le même tuple d'identifiant que other. Le tuple d'identifiant est composé du nom, du domaine et du chemin.

Voir aussi operator==().

bool QNetworkCookie::isHttpOnly() const

Renvoie true si le drapeau "HttpOnly" est activé pour ce cookie.

Un cookie "HttpOnly" n'est défini et récupéré que par les demandes et les réponses du réseau, c'est-à-dire par le protocole HTTP. Il n'est pas accessible aux scripts exécutés sur les navigateurs.

Voir également isSecure().

bool QNetworkCookie::isSecure() const

Renvoie true si l'option "secure" a été spécifiée dans la chaîne du cookie, false sinon.

Les cookies sécurisés peuvent contenir des informations privées et ne doivent pas être renvoyés sur des connexions non cryptées.

Voir aussi setSecure().

bool QNetworkCookie::isSessionCookie() const

Renvoie true si ce cookie est un cookie de session. Un cookie de session est un cookie qui n'a pas de date d'expiration, ce qui signifie qu'il doit être supprimé lorsque le concept de session de l'application est terminé (généralement, lorsque l'application se termine).

Voir aussi expirationDate() et setExpirationDate().

QByteArray QNetworkCookie::name() const

Renvoie le nom de ce cookie. Le seul champ obligatoire d'un cookie est son nom, sans lequel il n'est pas considéré comme valide.

Voir aussi setName() et value().

void QNetworkCookie::normalize(const QUrl &url)

Cette fonction normalise le chemin et le domaine du cookie s'ils étaient auparavant vides. Le paramètre url est utilisé pour déterminer le domaine et le chemin corrects.

[static] QList<QNetworkCookie> QNetworkCookie::parseCookies(QByteArrayView cookieString)

Analyse la chaîne de cookies cookieString telle qu'elle est reçue d'une réponse du serveur dans l'en-tête "Set-Cookie :". En cas d'erreur d'analyse, cette fonction renvoie une liste vide.

Comme l'en-tête HTTP peut définir plusieurs cookies en même temps, cette fonction renvoie une liste QList<QNetworkCookie>, une pour chaque cookie analysé.

Voir aussi toRawForm().

QString QNetworkCookie::path() const

Renvoie le chemin associé à ce cookie. Cela correspond au champ "path" de la chaîne du cookie.

Voir aussi setPath().

[since 6.1] QNetworkCookie::SameSite QNetworkCookie::sameSitePolicy() const

Renvoie l'option "SameSite" si elle est spécifiée dans la chaîne de cookies, SameSite::Default si elle n'est pas présente.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi setSameSitePolicy().

void QNetworkCookie::setDomain(const QString &domain)

Définit le domaine associé à ce cookie comme étant domain.

Voir aussi domain().

void QNetworkCookie::setExpirationDate(const QDateTime &date)

Fixe la date d'expiration de ce cookie à date. La fixation d'une date d'expiration non valide à ce cookie signifie qu'il s'agit d'un cookie de session.

Voir aussi isSessionCookie() et expirationDate().

void QNetworkCookie::setHttpOnly(bool enable)

Définit l'indicateur "HttpOnly" de ce cookie à enable.

Voir aussi isHttpOnly().

void QNetworkCookie::setName(const QByteArray &cookieName)

Définit le nom de ce cookie comme étant cookieName. Notez que la définition d'un nom de cookie avec un QByteArray vide rendra ce cookie invalide.

Voir également name() et value().

void QNetworkCookie::setPath(const QString &path)

Définit le chemin associé à ce cookie comme étant path.

Voir aussi path().

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

Définit l'option "SameSite" de ce cookie à sameSite.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi sameSitePolicy().

void QNetworkCookie::setSecure(bool enable)

Définit l'indicateur de sécurité de ce cookie à enable.

Les cookies sécurisés peuvent contenir des informations privées et ne doivent pas être renvoyés sur des connexions non cryptées.

Voir également isSecure().

void QNetworkCookie::setValue(const QByteArray &value)

Définit la valeur de ce cookie comme étant value.

Voir également value() et name().

[noexcept] void QNetworkCookie::swap(QNetworkCookie &other)

Remplace ce cookie par other. Cette opération est très rapide et n'échoue jamais.

QByteArray QNetworkCookie::toRawForm(QNetworkCookie::RawForm form = Full) const

Renvoie la forme brute de ce QNetworkCookie. Le QByteArray renvoyé par cette fonction convient pour un en-tête HTTP, soit dans une réponse du serveur (l'en-tête Set-Cookie), soit dans la requête du client (l'en-tête Cookie). Vous pouvez choisir l'un des deux formats en utilisant form.

Voir aussi parseCookies().

QByteArray QNetworkCookie::value() const

Renvoie la valeur de ce cookie, telle que spécifiée dans la chaîne du cookie. Notez qu'un cookie est toujours valide si sa valeur est vide.

Les paires nom-valeur de cookies sont considérées comme opaques pour l'application : c'est-à-dire que leurs valeurs ne signifient rien.

Voir aussi setValue() et name().

bool QNetworkCookie::operator!=(const QNetworkCookie &other) const

Renvoie true si ce cookie n'est pas égal à other.

Voir aussi operator==().

QNetworkCookie &QNetworkCookie::operator=(const QNetworkCookie &other)

Copie le contenu de l'objet QNetworkCookie other dans cet objet.

bool QNetworkCookie::operator==(const QNetworkCookie &other) const

Renvoie true si ce cookie est égal à other. Cette fonction ne renvoie true que si tous les champs du cookie sont identiques.

Cependant, dans certains contextes, deux cookies portant le même nom peuvent être considérés comme égaux.

Voir également operator!=() et hasSameIdentifier().