document.cookie

JavaScript -> Objekty -> Document -> Vlastnosť cookie

Syntax

cookie(obsah_cookie)

Popis

Príkaz jazyka JavaScript

Vlastnost cookie je další vlastností objektů document. Jde o jednoduchou řetězcovou vlastnost, která však prohlížeči umožňuje ukládat na straně klienta data trvanlivým způsobem, odtud název cookie – sušenka. Vlastnost cookie umožňuje manipulovat s daty mezi jednotlivými WWW stránkami, CGI skript na straně serveru může hodnotu cookie číst i zapisovat. Mimo to, že systém cookie byl navržen pro programátory CGI, je možné s hodnotami cookie manipulovat programově také pomocí JavaScriptu. Veškerá manipulace v JavaScriptu tak probíhá pomocí čtení a zápisu řetěcové hodnoty vlastnosti document.cookie

Hodnota cookie má následující strukturu:
název=hodnota
[;EXPIRES=datum_GMT]
[;DOMAIN=název_domény]
[;PATH=cesta]
[;SECURE]


Základem cookie je její povinný název, a povinná hodnota cookie, takže nejjednodušší zápis cookie může vypadat takto:
document.cookie = "heslo=pejsek"


Takový zápis vytvoří pouze dočasnou cookie, jejíž hodnota bude ztracena při ukončení prohlížeče. Další částí řetězce cookie je část EXPIRES, která značí dobu platnosti cookie, která je udána jako časový okamžik vyjádřený formátem GMT (univerzální čas), k jehož získání je možné použít metodu toGMTString( ) objektu Date:
var vyprseni=new Date("December 31,2000")
document.cookie='heslo=pejsek;EXPIRES=' +
vyprseni.toGMTString()


Pokud je třeba některou cookie odstranit, lze znovu nastavit její hodnotu EXPIRES na některý okamžik v minulosti.

Část řetězce cookie obsahující slovo DOMAIN udává rozsah platnosti cookie. Zde je možné specifikovat internetovou doménu, odkud bude hodnota cookie viditelná:
… ;DOMAIN=moje.cz; …

Takto nastavená cookie bude viditelná na všech stránkách domény moje.cz, jejichž umístění v doméně odpovídá nastavení v části PATH.

Část řetězcové hodnoty cookie PATH pak stejně určuje pro které dokumenty bude hodnota cookie přístupná na základě umístění dokumentu v cestě ve webové doméně:
… ;PATH=/novinky; …


Nastavená hodnota cookie je viditelná pro dokumenty uložené v moje.cz/novinky, cookie platí do 31. 12. 2000, název cookie je heslo a hodnotou je pejsek.

Poslední částí řetězce cookie je slovo SECURE, které, pokud je uvedeno, určuje, že při komunikaci se serverem bude cookie přenášena zabezpečeným spojením, implicitně není tato možnost použita.