• home
• why?
• download
• community
• source

Cookie Docs

The cookie library provides a simple API for setting and reading cookies. Using this library in browsers with cookie support you can easily store more pieces of data than you could with the standard browser minimum of support 20 cookies per web server. This is accomplished by storing one or more crumbs of data in a single cookie.

For safety, if you will use FORK.Cookie.isSupported() then keep your number of cookies to 19 or less otherwise keep your cookie use to 20 or less.

The number of crumbs is only limited by the total storage the browser allows for all cookies for a particular web server. The standard minimum is 4 KB but some browsers allow much more.

Cookies are transmitted with each request to the server. Keeping cookie use low will increase request-response speed.

Note that the order you create and store cookies and crumbs is meaningless.

API

isSupported()

Writes a test cookie named FORKtestcookie to the browser and then attempts to read it and then deletes it. If successful this function returns true and if not false. It is a good idea to call this function before using cookies if a particular action must be taken if the browser does not allow cookies.

Examples

if (FORK.Cookie.isSupported()) {
  var c = new FORK.Cookie('myFancyCookie');
  c.foo = 'a value';
  c.store();
} else {
  alert('enable cookies!');
}

var c = new FORK.Cookie('myFancyCookie');

var c = new FORK.Cookie('myFancyCookie');
c.foo = 'a value';
c.bar = 12345;
c.store();

var c = new FORK.Cookie('aCookie');
c.foo = 'a cookie value';
c.store(365, '/');

var c = new FORK.Cookie('myFancyCookie');
c.foo = 'a value';
c.bar = 12345;
c.store();
delete c.foo; // remove the "foo" crumb
c.z = 'xyz'; // add "z" crumb
c.store(); // save the changes

var c = new FORK.Cookie('aCookie');
c.foo = 'a cookie value';
c.store(365, '/');
c.remove(365, '/');