cookie-interceptor


> A simple JavaScript utility library for intercepting browser cookies

Live demo available at
here.

Installation

``sh
$ npm install cookie-interceptor
`

The CDN build is also available on unpkg:

- unpkg.com/cookie-interceptor/dist/cookie-interceptor.umd.js
- unpkg.com/cookie-interceptor/dist/cookie-interceptor.umd.min.js

Usage

`js
import CookieInterceptor from 'cookie-interceptor';

CookieInterceptor.init(); // Hijack the document.cookie object

CookieInterceptor.read.use(function (cookie) {
console.log('logger: ', cookie);
return cookie;
});

CookieInterceptor.disableRead().disableWrite();

document.cookie = 'date=20180915';
console.log(document.cookie); // => ''

CookieInterceptor.enableRead().enableWrite();

document.cookie = 'name=john';
console.log(document.cookie); // => 'name=john'
`

API

$3

You can intercept document.cookie before it is read or written.

`js
CookieInterceptor.read.use(function (cookie) {
console.log(cookie);
return cookie;
});

CookieInterceptor.write.use(function (val) {
console.log(val);
return val;
});
`

$3

- read.enabled / readEnabled: Check if the cookie is readable.
- read.enable() / enableRead(): Enable READ flag. You can read all cookies
with document.cookie property.
- read.disable() / disableRead(): Disable READ flag. document.cookie
will return an empty string.
- write.enabled / writeEnabled: Check if the cookie is writable.
- write.enable() / enableWrite(): Enable WRITE flag. You can write a new
cookie or update an existing cookie.
- write.disable() / disableWrite(): Disable WRITE flag.
document.cookie="key=value"` will not write a new cookie or update an
existing cookie.

Browsers support

|
IE / Edge |
Firefox |
Chrome |
Safari |
Opera |
| --------- | --------- | --------- | --------- | --------- |
| IE9, IE10, IE11, Edge| last 2 versions| last 2 versions| last 2 versions| last 2 versions

License

MIT

References

- Proxying of document.cookie - Stack Overflow