define("dojo/cookie", ["./_base/kernel", "./regexp"], function(dojo, regexp) { // module: // dojo/cookie // summary: // TODOC /*===== dojo.__cookieProps = function(){ // expires: Date|String|Number? // If a number, the number of days from today at which the cookie // will expire. If a date, the date past which the cookie will expire. // If expires is in the past, the cookie will be deleted. // If expires is omitted or is 0, the cookie will expire when the browser closes. // path: String? // The path to use for the cookie. // domain: String? // The domain to use for the cookie. // secure: Boolean? // Whether to only send the cookie on secure connections this.expires = expires; this.path = path; this.domain = domain; this.secure = secure; } =====*/ dojo.cookie = function(/*String*/name, /*String?*/value, /*dojo.__cookieProps?*/props){ // summary: // Get or set a cookie. // description: // If one argument is passed, returns the value of the cookie // For two or more arguments, acts as a setter. // name: // Name of the cookie // value: // Value for the cookie // props: // Properties for the cookie // example: // set a cookie with the JSON-serialized contents of an object which // will expire 5 days from now: // | dojo.cookie("configObj", dojo.toJson(config), { expires: 5 }); // // example: // de-serialize a cookie back into a JavaScript object: // | var config = dojo.fromJson(dojo.cookie("configObj")); // // example: // delete a cookie: // | dojo.cookie("configObj", null, {expires: -1}); var c = document.cookie, ret; if(arguments.length == 1){ var matches = c.match(new RegExp("(?:^|; )" + regexp.escapeString(name) + "=([^;]*)")); ret = matches ? decodeURIComponent(matches[1]) : undefined; }else{ props = props || {}; // FIXME: expires=0 seems to disappear right away, not on close? (FF3) Change docs? var exp = props.expires; if(typeof exp == "number"){ var d = new Date(); d.setTime(d.getTime() + exp*24*60*60*1000); exp = props.expires = d; } if(exp && exp.toUTCString){ props.expires = exp.toUTCString(); } value = encodeURIComponent(value); var updatedCookie = name + "=" + value, propName; for(propName in props){ updatedCookie += "; " + propName; var propValue = props[propName]; if(propValue !== true){ updatedCookie += "=" + propValue; } } document.cookie = updatedCookie; } return ret; // String|undefined }; dojo.cookie.isSupported = function(){ // summary: // Use to determine if the current browser supports cookies or not. // // Returns true if user allows cookies. // Returns false if user doesn't allow cookies. if(!("cookieEnabled" in navigator)){ this("__djCookieTest__", "CookiesAllowed"); navigator.cookieEnabled = this("__djCookieTest__") == "CookiesAllowed"; if(navigator.cookieEnabled){ this("__djCookieTest__", "", {expires: -1}); } } return navigator.cookieEnabled; }; return dojo.cookie; });