Sets or gets the string value of a cookie.
Syntax
[ sCookie = ] document.cookie
Possible Values
| sCookie | String that
specifies or receives the name=value; pairs, plus any of the values listed in Possible Values. | expires=date; | If you set no expiration date on a cookie, it expires when the browser closes. If you set an expiration date, the cookie is saved across browser sessions. If you set an expiration date in the past, the cookie is deleted. Use Greenwich Mean Time (GMT) format to specify the date. | | domain=domainname; | If you set the domain of the cookie, pages on a domain made up of more than one server can share cookie information. | | path=path; | If you set a path for the cookie, the current document can share cookie information with other pages within the same domain—that is, if the path is set to /thispathname, all pages in /thispathname and all pages in subfolders of /thispathname can access the same cookie information. | secure; | If you set a cookie as secure;, the stored cookie information can be accessed only from a secure environment. |
|
The property is read/write.
The property has no default value.
Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties.
Remarks
A cookie is a small piece of information stored by the browser. Each cookie is stored in a name=value pair called a crumb—that is, if the cookie name is "id" and you want to save the id value as "this," the cookie is saved as id=this. You can store up to a maxium of 50 name=value pairs in a cookie; the cookie is always returned as a string of all the cookies that apply to the page. This means that you must parse the string returned to find the values of individual cookies.
Cookies accumulate each time the property is set. Once the maxium pair limit is reached, subsequent set will push older name=value pair off in favor of the new name=value pair.
You can use the Microsoft JScript split method to extract a value stored in a cookie.
Examples
This example creates a cookie with a specified name and value. The value is passed to the JScript escape function to ensure that the value contains only valid characters. When you get the cookie, use the JScript unescape function to translate the value back to its original form.
<SCRIPT>
// Create a cookie with the specified name and value.
// The cookie expires at the end of the 21st century.
function SetCookie(sName, sValue)
{
date = new Date();
document.cookie = sName + "=" + escape(sValue) + "; expires=Fri, 31 Dec 2099 23:59:59 GMT;";
}
</SCRIPT>
This example gets the value of the portion of the cookie specified by the sCookie
parameter.
<SCRIPT>
// Get the value of the cookie with the specified name.
function GetCookie(sName)
{
// cookies are separated by semicolons
var aCookie = document.cookie.split("; ");
for (var i=0; i < aCookie.length; i++)
{
// a name/value pair (a crumb) is separated by an equal sign
var aCrumb = aCookie[i].split("=");
if (sName == aCrumb[0])
return unescape(aCrumb[1]);
}
// a cookie with the requested name does not exist
return null;
}
</SCRIPT>
This example deletes a cookie by setting its expires attribute to a past date. A cookie deleted in this manner might not be removed immediately by the browser.
<SCRIPT>
// Delete the cookie with the specified name.
// The value of the cookie is unnecessary.
function DelCookie(sName)
{
document.cookie = sName + "=; expires=Fri, 21 Dec 1976 04:31:24 GMT;";
}
</SCRIPT>
This feature requires Microsoft® Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.
Standards Information
This property is defined in
World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 
.
Applies To
See Also
Introduction to Persistence, Privacy in Internet Explorer 6