WebResponse.SetCookie
| WebResponse = class static (TObject) | Interface de WebResponse | Exemples de WebResponse |
Qubes 6.2 Défini un cookie dans la réponse HTTP
Syntaxe
class procedure SetCookie(name: String; value: String; expiresGMT: Float = 0)
class procedure SetCookie(name: String; value: String; expiresGMT: Float; path: String; domain: String = ''; flags: Integer = 0)
class procedure SetCookie(name: String; value: String; expiresGMT: Float; path: String; domain: String = ''; flags: Integer = 0; sameSite: WebCookieSameSite = 0) (Qubes 7.0)
name: nom du cookie
value: valeur du cookie
expiresGMT: expiration éventuelle pour le cookie
path: chemin de restriction éventuel pour le cookie
domaine: domaine de restriction éventuel pour le cookie
flags: options éventuelles pour le cookie
sameSite: réglage de sécurité "same-site" pour le cookie
Remarques
Pour une référence normative sur les cookies, se référer à https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies
Il est possible (st souvent préférable) de restreindre le cookie en spécifiant les paramètre path et domain.
Les flags disponibles sont définis dans WebCookieFlag.
Voir aussi WebRequest.Cookie.
Exemples
// cookie de préférences simple, sans options de sécurité
WebResponse.SetCookie('theme', 'flowers');
// cookie d'accès sécurisé, limité à un chemin, un domaine, sécurisé, et non-accessible au javascript
WebResponse.SetCookie(
'secure', nonce, // nom et valeur
UTCDateTime + 1/24, // expiration 1 heure après l'heure courante
'/WebProcess.cit/PWEB0001', // restreint à un webprocess particulier
'my.server.com', // restreint à ce domaine précis
WebCookieFlag.Secure + WebCookieFlag.HttpOnly,
WebCookieSameSite.Strict
);
WebResponse.SetCookie('theme', 'flowers');
// cookie d'accès sécurisé, limité à un chemin, un domaine, sécurisé, et non-accessible au javascript
WebResponse.SetCookie(
'secure', nonce, // nom et valeur
UTCDateTime + 1/24, // expiration 1 heure après l'heure courante
'/WebProcess.cit/PWEB0001', // restreint à un webprocess particulier
'my.server.com', // restreint à ce domaine précis
WebCookieFlag.Secure + WebCookieFlag.HttpOnly,
WebCookieSameSite.Strict
);