{쿠커}8.document.cookie 객체

document.cookie 객체의 구조

자바스크립트에서는 document.cookie 객체를 통해 쿠키에 접근할 수 있습니다. 이 객체는 대입연산자를 통해 새로운 값을 내부 쿠키 리스트에 추가할 수 있습니다.

[code javascript;gutter:false] document.cookie = "ID=123456789";
document.cookie = "PW=abcdefghi"; [/code]

위와 같은 자바스크립트를 수행하면 일반적인 대입문처럼 쿠키명 ID가 없어지는 것이 아니라 내부 쿠키 리스트에 ID라는 쿠키와 PW라는 쿠키가 추가될 것입니다. 만약 쿠키명이 일치하는 것이 내부 쿠키 리스트에 있었다면 새로운 값으로 대치될 것입니다.

이미 생성되어 있는 쿠키를 참조하려면 document.cookie 객체를 문자열처럼 다루면 됩니다. 이 문자열은 쿠키명과 쿠키값으로 구성되어 있습니다. 각 쿠키명과 쿠키값은 등호(=)로 구분되어 있고, 각각의 쿠키는 세미콜론(;)으로 구분되어 있습니다. 위와 같이 쿠키가 생성되었을 때 document.cookie 객체를 참조하면 "ID=123456789;PW=abcdefghi"라는 문자열을 얻을 수 있습니다. 이 문자열을 가지고 문자열 메소드인 indexOf() 또는 substring() 함수를 이용하면 각 쿠키에 대한 정보를 분리할 수 있을 것입니다. 이러한 예는 아래에 있는 사용자 정의 함수 getCookie()를 참조하기 바랍니다.

PHP에서와 마찬가지로 유효한 도메인과 유효한 경로에서 만들어 낸 쿠키 정보만이 document.cookie을 통해서 볼 수 있습니다.

document.cookie 객체를 직접 사용할 수도 있지만, 대부분 아래와 같이 미리 정의된 함수 setCookie(), getCookie(), delCookie()를 통해 쿠키를 다루게 됩니다.

쿠키 설정하기

PHP의 setcookie() 함수와는 달리 expires(유효기간) 매개변수의 단위는 천분의 일초단위로 설정합니다. secure가 다소 다르기는 하지만 다른 매개변수는 PHP와 별다르지 않습니다. 저장된 쿠키 정보를 보면 문자열 소스 차원에서 PHP에서 다룰 때와 동일하지 않습니다. 왜냐하면 PHP에서 인코딩/디코딩하는 방식과 자바스크립트에서 인코딩/디코딩하는 방식이 다르기 때문입니다. 따라서 양쪽의 함수를 혼용하여 사용하는데는 문제가 있으니 주의하기 바랍니다. 여기에 정의된 setCookie() 함수는 "Designing Dynamic Web Pages with JavaScript"의 저자 Nick Heinle의 작품을 변형시킨 것입니다. 본래의 함수는 서적을 참조하시기 바랍니다. 이 원서에 대한 번역서는 "자바스크립트로 다이나믹 웹페이지 디자인하기"라는 제목으로 나와 있습니다.

[code javascript;gutter:false] function setCookie(name, value, expires, path, domain, secure) {
secure = (secure == null) ? false : secure;
var exp = new Date();
exp.setTime(expires);
document.cookie = name + "=" + escape(value)
+ ((expires == null) ? "" : ("; expires=" + exp.toGMTString()))
+ ((path == null) ? "" : ("; path=" + path))
+ ((domain == null) ? "" : ("; doamin=" + domain))
+ ((secure == true) ? "; secure" : "");
} [/code]

예를 들어 아래와 같이 각 매개변수를 지정할 수 있으며, 이 때 유효기간은 1시간이 됩니다.

[code javascript;gutter:false] setCookie(
"mycookie", // 쿠키명
"cookie_value", // 쿠키값
exp.getTime()+1000*3600, // 유효 기간
"/exam", // 유효 디렉토리
".phpclass.com" // 유효 도메인
); [/code]

쿠키 정보 읽어오기

쿠키명과 값은 document.cookie 객체에 통해 참조될 수 있습니다. 자바스크립트가 저장하는 쿠키의 형태는 아래와 같으며 각각의 name=value 쌍은 세리콜론과 공백으로 구분되어지고 제일 마지막 값에는 세미콜론이 없습니다.

[code javascript;gutter:false] name1=value1; name2=value2; name3=value3 [/code]

쿠키의 값을 좀 더 쉽게 얻기 위해 다음과 같이 getCookie() 함수를 정의하여 사용합니다. 이 함수는 Nick Heinle의 작품을 그대로 가져왔습니다.

[code javascript;gutter:false] // Heinle's function for retrieving a cookie.
function getCookie(name) {
var cname = name + "=";
var dc = document.cookie;
if (dc.length > 0) {
begin = dc.indexOf(cname);
if (begin != -1) {
begin += cname.length;
end = dc.indexOf(";", begin);
if (end == -1)
end = dc.length;
return unescape(dc.substring(begin, end));
}
}
return null;
} [/code]

이 함수는 단지 쿠키명만 지정하여 주면 document.cookie 객체를 검사하여 해당 쿠키의 값을 되돌려 줍니다. 저장된 쿠키가 없는 경우에는 null 값을 되돌려 줍니다.

[code javascript;gutter:false] value = getCookie ("mycookie"); [/code]

쿠키 삭제하기

마지막으로 쿠키를 삭제할 수 있는 함수 delCookie()를 살펴보겠습니다. 이 함수는 쿠키 센추럴(www.cookiecentral.com)에 있는 Dorcht의 함수를 그대로 가져왔습니다.

[code javascript;gutter:false] function delCookie (name, path, domain) {
if (getCookie(name)) {
document.cookie = name + "="
+ ((path == null) ? "" : "; path=" + path)
+ ((domain == null) ? "" : "; domain=" + domain)
+ "; expires=Thu, 01-Jan-70 00:00:01 GMT";
}
} [/code]

delCookie() 함수는 쿠키 파일에서 쿠키를 삭제하기 위해 사용되는 함수이다. delCookie() 함수를 사용하기 위해서는 보통 쿠키명만 넘겨주면 된다. 그러나 setCookie() 함수에서 쿠키를 구울 때 path와 domain을 지정하였으면, delCookie() 함수로 지울 때도 동일할 path와 domain을 분명히 지정해 주어야 합니다. 예를 들어, "mycookie" 쿠키에 대한 정보는 다음과 같이 지울 수 있습니다.

[code javascript;gutter:false] delCookie("mycookie", "/exam", ".phpclass.com"); [/code]

구두점 인코딩/디코딩

브라우저가 등호(=)와 세미콜론(;)을 각 쿠키를 분리시키는 구분자로 사용하기 때문에, 이것들은 자신이 저장하는 텍스트안에 넣을 수가 없습니다. 이러한 특수 코드를 쿠키값에 저장하려면 document.cookie 객체에 문자열을 넘기기 전에 escape()를 사용하여 인코딩해야 하고, unescape()를 사용하여 복구하여야 합니다.

escape() 함수

일반문자를 ASCII 형식(URL 형식; 폼에서 보내어진 %가 붙은 문자) 문자로 변환합니다. 예를 들어 아래와 같이 "ASCII &? 문자"라는 문자열을 escape() 함수로 넘겨주면 "ASCII%20%26%3F%20%uBB38%uC790"라는 문자열을 되돌려 받습니다.

[code javascript;gutter:false] var encode = escape("ASCII &? 문자"); [/code]

unescape() 함수

ASCII 형식(URL 형식) 문자를 일반문자로 변환합니다. 예를 들어 아래와 같이 "ASCII%20%26%3F%20%uBB38%uC790"라는 문자열을 unescape() 함수로 넘겨주면 "ASCII &? 문자"라는 문자열을 되돌려 받습니다.

[code javascript;gutter:false] var decode = unescape("ASCII%20%26%3F%20%uBB38%uC790"); [/code]