slexx1234/cookie.js

Cookie Manipulation API

tasty-cookies

Language: Russian, English

Table of contents

• Quick start
• Browser Compatibility
• Use in CommonJS/Nodey
• API Reference
  • Cookie.set(key, value, [options])
  • Cookie.get(keys...)
  • Cookie.remove(keys...)
  • Cookie.keys()
  • Cookie.all()
  • Cookie.clear()
  • Cookie.getLength()
  • Cookie.noConflict()

Quick start

• Download the latest release
• Install with Bower: bower install tasty-cookies
• Install with npm: npm install tasty-cookies

Browser Compatibility

Full support (95.9% global browser share)

• Chrome 4+
• iOS Safari 4+
• UC Browser for Android 9.9+
• Firefox 3.5+
• Opera 10.5+
• Firefox for Android 32+
• Opera Mini 5+
• IE 8+
• Safari 4+

Use in CommonJS/Node

In environments where there is no native window object, tasty-cookies will export a factory method that accepts a window instance. For example, using jsdom, you might do something like:

var window = require('jsdom').jsdom().parentWindow;
var Cookie = require('tasty-cookies')(window);

API Reference

Methods

• Cookie.set(key, value, [options])
• Cookie.get(keys...)
• Cookie.remove(keys...)
• Cookie.keys()
• Cookie.all()
• Cookie.clear()
• Cookie.getLength()
• Cookie.noConflict()

Example:

Cookie.set({
        string: 'Hello, World!',
        array: [1, 2, 3]
    })
    .set('object', {one: 1, two: 2});

console.log(Cookie.get('string'));
// -> 'Hello, World!'

Cookie.remove('string');

console.log(Cookie.get('string'));
// -> undefined
console.log(Cookie.get('array'));
// -> [1, 2, 3]
console.log(Cookie.get('object'));
// -> {one: 1, two: 2}

Cookie.set(key, value, [options])

Set cookies

Source

Arguments:

Name	Type	Description
key	String, Object	Cookie key
[value]	*	Cookie value
[options]	Object	Options for cookie Properties: Name Type Description [expires] Number Cookie expiration time (in days) [path] String Path for cookie [domain] String Domain for cookie [secure] Boolean Transfer cookies only over a secure connection.

Return: Cookie

Example:

Cookie.set('my_cookie', 5);
console.log(document.cookie)
// -> 'my_cookie=5'

// -- OR --

Cookie.set({
  one: 1,
  two: 2
});

console.log(document.cookie);
// -> 'one=1; two=2'

Cookie.get(keys...)

Getting cookies

Source

Arguments:

Name	Type	Description
keys...	String	Cookie keys

Return: *

Example:

Cookie.set('my_cookie', 5);
console.log(Cookie.get('my_cookie'));
// -> 5

Cookie.set('my_cookie', [1, 2, 3]);
console.log(Cookie.get('my_cookie'));
// -> [1, 2, 3]

Cookie.set({one: 1, two: 2});
console.log(Cookie.get('one', 'two'));
// -> {one: 1, two: 2}

Cookie.remove(keys...)

Remove cookies

Source

Arguments:

Name	Type	Description
keys...	String	Cookie keys

Return: Cookie

Example:

Cookie.set('my_cookie', 5);
console.log(document.cookie)
// -> 'my_cookie=5'

Cookie.remove('my_cookie')
console.log(document.cookie)
// -> ''

Cookie.set({one: 1, two: 2});
Cookie.remove('one', 'two');
console.log(document.cookie)
// -> ''

Cookie.keys()

Getting all keys cookies

Source

Return: Array

Example:

Cookie.set({
  one: 1,
  two: 2
});

console.log(Cookie.keys());
// -> ['one', 'two']

Cookie.all()

Getting all cookies

Source

Return: Object

Example:

Cookie.set({one: 1, two: 2});
console.log(Cookie.all());
// -> {one: 1, two: 2}

Cookie.clear()

Clear all cookies

Source

Return: Cookie

Example:

Cookie
  .set({one: 1, two: 2})
  .clear();
  
console.log(document.cookie);
// -> ''

Cookie.getLength()

Getting length of all cookies

Source

Example:

Cookie.set({one: 1, two: 2});

console.log(Cookie.getLength());
// -> 2

Return: Number

Cookie.noConflict()

Exemption name Cookie

Source

Return: Cookie

Example:

var Cookie2 = Cookie.noConflict();

console.log(typeof Cookie2);
// -> 'function'

Cookie2.set('my_cookie', 5);

console.log(Cookie2.get('my_cookie'));
// -> 5

cookie.js's Issues

Expires option measure

It's unclear that expires value is number of days. I think it should be specified in documentation.

exports is not defined

I've copied content of cookie.min.js into browser's console and get ReferenceError:

Uncaught ReferenceError: exports is not defined