/ember-cookies

Cookies abstraction for Ember.js that works both in the browser as well as with Fastboot on the server

Primary LanguageJavaScriptMIT LicenseMIT

Build Status

ember-cookies

ember-cookies implements an abstract cookie API that works both in the browser (via document.cookie) as well as with Fastboot in the server context (using the request and response accessible via the fastBoot service).

Having access to cookies both in the browser as well as in FastBoot is key to being able to share a common session.

Installation

Install ember-cookies with

ember install ember-cookies

Example Usage

// app/controllers/application.js
import Ember from 'ember';

const { inject: { service }, computed } = Ember;
const { keys } = Object;

export default Ember.Controller.extend({
  cookies: service(),

  allCookies: computed(function() {
    let cookieService = this.get('cookies');
    cookieService.write('now', new Date().getTime());

    let cookies = cookieService.read();
    return keys(cookies).reduce((acc, key) => {
      let value = cookies[key];
      acc.push({ name: key, value });

      return acc;
    }, []);
  })
});

API

The cookies service has methods for reading and writing cookies:

  • read(name): reads the cookie with the given name, returns its value as a String.
  • write(name, value, options = {}): writes a cookie with the given name and value; options can be used to set domain, expires (Date), maxAge (time in seconds), path and secure.
  • clear(name, options = {}): clears the cookie so that future reads do not return a value; options can be used to specify domain, path or secure.

License

ember-cookies is developed by and © simplabs GmbH and contributors. It is released under the MIT License.

ember-cookies is not an official part of Ember.js and is not maintained by the Ember.js Core Team.