home *** CD-ROM | disk | FTP | other *** search
/ Revista CD Expert 36 / CDE36_B / CDE36_B.mdf / Gem / GemMaster.exe / GemMaster / Cookie.js < prev    next >
Encoding:
JavaScript  |  1999-09-21  |  4.6 KB  |  106 lines
  1. /************************************************************************************
  2. *************************************************************************************
  3. * Cookie FUNCTIONS OF DEATH                                                            *
  4. *************************************************************************************
  5. ************************************************************************************/
  6.  
  7. //  Function to correct for 2.x Mac date bug.  Call this function to
  8. //  fix a date object prior to passing it to SetCookie.
  9. //  IMPORTANT:  This function should only be called *once* for
  10. //  any given date object!  See example at the end of this document.
  11. function FixCookieDate (date) {
  12.   var base = new Date(0);
  13.   var skew = base.getTime(); // dawn of (Unix) time - should be 0
  14.   if (skew > 0)  // Except on the Mac - ahead of its time
  15.     date.setTime (date.getTime() - skew);
  16. }
  17.  
  18. //  Function to return the value of the cookie specified by "name".
  19. //    name - String object containing the cookie name.
  20. //    returns - String object containing the cookie value, or null if
  21. //      the cookie does not exist.
  22. function GetCookie (name) {
  23.   var arg = name + "=";
  24.   var alen = arg.length;
  25.   var clen = document.cookie.length;
  26.   var i = 0;
  27.   while (i < clen) {
  28.     var j = i + alen;
  29.     if (document.cookie.substring(i, j) == arg)
  30.       return getCookieVal (j);
  31.     i = document.cookie.indexOf(" ", i) + 1;
  32.     if (i == 0) break; 
  33.   }
  34.   return null;
  35. }
  36.  
  37. //  Function to create or update a cookie.
  38. //    name - String object containing the cookie name.
  39. //    value - String object containing the cookie value.  May contain
  40. //      any valid string characters.
  41. //    [expires] - Date object containing the expiration data of the cookie.  If
  42. //      omitted or null, expires the cookie at the end of the current session.
  43. //    [path] - String object indicating the path for which the cookie is valid.
  44. //      If omitted or null, uses the path of the calling document.
  45. //    [domain] - String object indicating the domain for which the cookie is
  46. //      valid.  If omitted or null, uses the domain of the calling document.
  47. //    [secure] - Boolean (true/false) value indicating whether cookie transmission
  48. //      requires a secure channel (HTTPS).  
  49. //
  50. //  The first two parameters are required.  The others, if supplied, must
  51. //  be passed in the order listed above.  To omit an unused optional field,
  52. //  use null as a place holder.  For example, to call SetCookie using name,
  53. //  value and path, you would code:
  54. //
  55. //      SetCookie ("myCookieName", "myCookieValue", null, "/");
  56. //
  57. //  Note that trailing omitted parameters do not require a placeholder.
  58. //
  59. //  To set a secure cookie for path "/myPath", that expires after the
  60. //  current session, you might code:
  61. //
  62. //      SetCookie (myCookieVar, cookieValueVar, null, "/myPath", null, true);
  63. //
  64. function SetCookie (name, value, expires, path, domain, secure) {
  65.     document.cookie = name + "=" + escape (value) +
  66.         ((expires) ? "; expires=" + expires.toGMTString() : "") +
  67.         ((path) ? "; path=" + path : "") +
  68.         ((domain) ? "; domain=" + domain : "") +
  69.         ((secure) ? "; secure" : "");
  70. }
  71.  
  72. // "Internal" function to return the decoded value of a cookie
  73. function getCookieVal (offset) {
  74.     var endstr = document.cookie.indexOf (";", offset);
  75.     if (endstr == -1)
  76.         endstr = document.cookie.length;
  77.     return unescape(document.cookie.substring(offset, endstr));
  78. }
  79.  
  80. //  Function to delete a cookie. (Sets expiration date to start of epoch)
  81. //    name -   String object containing the cookie name
  82. //    path -   String object containing the path of the cookie to delete.  This MUST
  83. //             be the same as the path used to create the cookie, or null/omitted if
  84. //             no path was specified when creating the cookie.
  85. //    domain - String object containing the domain of the cookie to delete.  This MUST
  86. //             be the same as the domain used to create the cookie, or null/omitted if
  87. //             no domain was specified when creating the cookie.
  88. function DeleteCookie (name,path,domain) {
  89.   if (GetCookie(name)) {
  90.     document.cookie = name + "=" +
  91.       ((path) ? "; path=" + path : "") +
  92.       ((domain) ? "; domain=" + domain : "") +
  93.       "; expires=Thu, 01-Jan-70 00:00:01 GMT";
  94.   }
  95. }
  96.  
  97. /*  Examples
  98.     var expdate = new Date ();
  99.     FixCookieDate (expdate); // Correct for Mac date bug - call only once for given Date object!
  100.     expdate.setTime(expdate.getTime() + (24 * 60 * 60 * 1000) * 180 ); // 6 months from now
  101.     
  102.     var cookieValue = "Werd";
  103.         
  104.     SetCookie ("WTMapCookie", cookieValue , expdate);
  105.     GetCookie ("WTMapCookie")
  106. */