A cookies plugin for Aurelia.
Webpack/Aurelia CLI
npm install aurelia-plugins-cookies --saveWhen using Aurelia CLI add the following dependency to aurelia.json as described in the documentation:
{
"name": "aurelia-plugins-cookies",
"path": "../node_modules/aurelia-plugins-cookies/dist/amd",
"main": "aurelia-plugins-cookies"
}Add node_modules/babel-polyfill/dist/polyfill.min.js to the prepend list in aurelia.json. Do not forgot to add babel-polyfill to the dependencies in package.json.
For projects using Webpack, please add babel-polyfill to your webpack.config.js as documented by babeljs.io.
JSPM
jspm install aurelia-plugins-cookiesBower
bower install aurelia-plugins-cookiesIt is not necessary to load the plugin inside of the configure method of your main.js or main.ts, because this plugin doesn't use any dependencies of Aurelia. The only thing you need to be sure of, is that the library is loaded in your project.
The plugin is used as a class with static methods. No dependency injection is necessary. Just import it in your own class.
The following methods are provided:
import {Cookies} from 'aurelia-plugins-cookies';
export class App {
// Returns the value (string) of the given cookie key
Cookies.get(key);
// Returns a key/value object with all the cookies
Cookies.getAll();
// Returns the deserialized value (object) of the given cookie key
Cookies.getObject(key);
// Sets a value (string) for the given cookie key
Cookies.put(key, value, [options]);
// Sets a serialized value (object) for the given cookie key
Cookies.putObject(key, value, [options]);
// Remove the cookie with the given cookie key
Cookies.remove(key, [options]);
// Removes all the cookies
Cookies.removeAll();
}Cookie options can be set by passing a plain object in the last argument to Cookies.put(...).
A string indicating a valid domain where the cookie should be visible. The cookie will also be visible to all subdomains.
Cookies.put('key', 'value', { domain: 'subdomain.site.com' });Define when the cookie will be removed. Value can be a string which will be converted to a date or a Date instance. If omitted, the cookie becomes a session cookie.
Cookies.put('key', 'value', { expires: 'Fri, 09 Sep 2016 00:00:01 GMT' });A string indicating the path where the cookie is visible.
Cookies.put('key', 'value', { path: '/' });Either true or false, indicating if the cookie transmission requires a secure protocol (https).
Cookies.put('key', 'value', { secure: true });