JsLib 1.4

Script cookies.js


Le script cookies.js permet de lire, d'écrire et d'effacer les cookies de la page Web courante.

Un cookie est une variable contenant une chaîne de caractères qui est enregistrée par le navigateur du client dans un fichier. Un cookie possède une date d'expiration ; jusqu'à cette date, il reste accessible à tout moment à partir de la page Web qui a créé le cookie, même une fois que le navigateur est fermé.

Au chargement du script, on vérifie que le navigateur du client accepte les cookies. Pour cela, on se base sur la propriété navigator.cookieEnabled. Ensuite, trois fonctions permettent d'écrire une variable cookie, de lire sa valeur et de l'effacer.

Depuis :
JsLib 1.0

 
Résumé des fonctions
 booléen accepteCookies()
           Indique si le navigateur accepte les cookies.
  ecrireCookie(chaîne nom, chaîne valeur, entier jours)
           Ecrit un cookie de nom et valeur spécifiées pour le nombre de jours spécifié.
  effacerCookie(chaîne nom)
           Efface le cookie de nom spécifié.
 chaîne lireCookie(chaîne nom)
           Lit et retourne la valeur du cookie de nom spécifié.
 
Détail des fonctions

accepteCookies

booléen accepteCookies()
Indique si le navigateur accepte les cookies.
Retourne :
true si le navigateur accepte d'enregistrer les cookies, false sinon.

ecrireCookie

ecrireCookie(chaîne nom, chaîne valeur, entier jours)
Ecrit un cookie de nom et valeur spécifiées pour le nombre de jours spécifié. La date d'expiration du cookie est calculée à partir du paramètre jours. Une fois cette date atteinte, le cookie est effacé par le navigateur. Si le paramètre jours est omis, le cookie expire à la fermeture du navigateur.
Paramètres :
nom - le nom identifiant la variable cookie à créer.
valeur - la valeur de la variable cookie à créer.
jours - le nombre de jours avant l'expiration de la variable cookie (facultatif).

effacerCookie

effacerCookie(chaîne nom)
Efface le cookie de nom spécifié. En réalité, ré-écrit le cookie avec une valeur nulle et une date d'expiration inférieure à la date courante.
Paramètres :
nom - le nom identifiant la variable cookie à effacer.

lireCookie

chaîne lireCookie(chaîne nom)
Lit et retourne la valeur du cookie de nom spécifié.
Paramètres :
nom - le nom identifiant la variable cookie à lire.
Retourne :
une chaîne contenant la valeur de la variable cookie, ou une chaîne vide si la variable cookie n'existe pas.

JsLib 1.4

Erreurs, critiques, améliorations, questions : écrivez à l'auteur.
 
JsLib version 1.4 - bibliothèque JavaScript distribuée sous licence GNU LGPL
Auteur : Etienne CHEVILLARD
Mise à jour : 12/12/2007