npm

advanced-cookie-manager

0.1.4 • Public • Published

Advanced Cookie Manager

v 1.1.4 (02192017)

Small client-side javascript library that makes managing cookies easy.

Features
Browser Compatibility
Getting the Library
API Reference

Features

  • RFC6265 compliant
  • Cross browser
  • Lightweight
  • No dependencies

Browser Compatibility

The following browsers have passed all of the automated Cookies.js tests:

  • Chrome
  • Firefox 3+
  • Safari 4+
  • Opera 10+
  • Internet Explorer 6+

Getting the Library

Direct downloads

v1.1.4 (~ 13.94 KB) v1.1.4 Minified (~ 2.52 KB)

API Reference

Methods
acm.initialize(options)
acm.set(key, value, options = {})
acm.get(key)
acm.unset(key)

Properties

Expires

A number (of seconds), a number parsable string, or a Date object of when the cookie will expire. By default is 0 (session cookie).

Example Usage

acm.expires = 3600; // Expires number format 1 hour
acm.expires = '3600'; // Expires string format 1 hour
acm.expires = new Date(2020, 0, 1); // Expires at Wed Jan 01 2020 00:00:00 GMT+0200

Path

A string value of the path of the cookie. By default is '/'.

Example Usage

acm.path = '/'; // Path for all pages
acm.path = '/cart'; // Path only for /cart page
acm.path = '/success'; // Path only for /success page

Domain

A string value of the domain of the cookie. By default is equal to current domain.

Example Usage

acm.domain = 'www.example.com'; // Set www.example.com as default domain

Secure

A boolean value of whether or not the cookie should only be available over SSL. By default is false.

Just now it deprecated and dosen't use.

Additional properties

Debug

Enable debug option set show in console information about create/delee cookie.

Example Usage

acm.debug = false; // disable
acm.debug = true; // enable

Encode

Set encode cookie encodeUri() value (encode by default), you can disable/enable this option.

Example Usage

acm.encode = false; // disable
acm.encode = true; // enable

Methods

acm.initialize(options)

Set default options for all new cookies

Example Usage

// Initialize all options
acm.initialize({
    expires : 3600,
    path : '/',
    domain : 'www.example.com',
});

// Initialize expires
acm.initialize({
    expires : 3600,
});

And now all new cookies without options has this options as default.

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

Sets a cookie in the document. If the cookie already exist, it will be rewrite it.

Option Description Default
expires A number (of seconds), a number parsable string, or a Date object of when the cookie will expire 0
path A string value of the path of the cookie /
domain A string value of the domain of the cookie empty
secure A boolean value of whether or not the cookie should only be available over SSL (deprecated) false

Example Usage

// Setting a cookie value
acm.set('key', 'value');

// Setting cookies with additional options
acm.set('key', 'value', { domain: 'www.example.com'});

// Setting cookies with expiration values
acm.set('key', 'value', { expires: 3600 }); // Expires in 1 hour
acm.set('key', 'value', { expires: '3600' }); // Expires in 1 hour
acm.set('key', 'value', { expires: new Date(2020, 0, 1) }); // Expires at Wed Jan 01 2020 00:00:00 GMT+0200

acm.get(key)

Returns the value of the most locally scoped cookie with the specified key.

Example Usage

// Get the cookie value
acm.get('key'); // "value"

If key is empty acm() method return all locally scoped cookies as array of items (cookies).

Example Usage

// Get all cookies
acm.get(); // [[name  : name, value : value], [...], ...}]

acm.unset(key)

Unse the most locally scoped cookie with the specified key.

Example Usage

// Unset the cookie
acm.unset('key');

Readme

Keywords

none

Package Sidebar

Install

npm i advanced-cookie-manager

Weekly Downloads

5

Version

0.1.4

License

MIT

Last publish

Collaborators

  • evgv