cookie-dough

0.1.0 • Public • Published

cookie-dough

An isomorphic JavaScript cookie library.

Wraps https://www.npmjs.com/package/cookie to work on the client and server. Also, required is having parsed cookies in express (for now).

Usage

Geting a cookie

// client-side
// automatically parses the cookies for the page
var cookie = require('cookie-dough')();
cookie.get('name');
 
// server-side
var express = require('express'),
    CookieDough = require('cookie-dough'),
    cookieParser = require('cookie-parser');
 
var app = express();
app.use(cookieParser());
 
app.get('/', function(req, res){
  var cookie = new CookieDough(req); // req is required when creating an instance
  cookie.get('name');
});

Getting all the cookies

// client-side
// automatically parses the cookies for the page
var cookie = require('cookie-dough')();
 
// returns an object with all of the cookies
// format: { cookieName: "cookie value" }
cookie.all();
 
// server-side
var express = require('express'),
    CookieDough = require('cookie-dough'),
    cookieParser = require('cookie-parser');
 
var app = express();
app.use(cookieParser());
 
app.get('/', function(req, res){
  var cookie = new CookieDough(req);
  cookie.all();
});

Setting a cookie

// client-side
var cookie = require('cookie-dough')();
cookie.set('name', 'value', { /* options */ });
 
// server-side
var express = require('express'),
    CookieDough = require('cookie-dough'),
    cookieParser = require('cookie-parser');
 
var app = express();
app.use(cookieParser());
 
app.get('/', function(req, res){
  var cookie = new CookieDough(req);
  cookie.set('name', 'value', { /* options */ });
});

The options that you can set on a cookie:

path - cookie path

expires - absolute expiration date for the cookie (Date object)

maxAge - relative max age of the cookie from when the client receives it (seconds)

domain - domain for the cookie

secure - true or false

httpOnly - true or false

Removing a cookie

// client-side
var cookie = require('cookie-dough')();
cookie.remove('name', { /* options */ });
 
// server-side
var express = require('express'),
    CookieDough = require('cookie-dough'),
    cookieParser = require('cookie-parser');
 
var app = express();
app.use(cookieParser());
 
app.get('/', function(req, res){
  var cookie = new CookieDough(req);
  cookie.remove('name');
});

The options that can be set to remove a cookie are:

path - cookie path

domain - domain for the cookie

Package Sidebar

Install

npm i cookie-dough

Weekly Downloads

1,813

Version

0.1.0

License

MIT

Last publish

Collaborators

  • saponifi3d