js-cookie integration with other frameworks, like AngularJS

[FagnerMartinsBrack]

Since js-cookie has no dependencies it is pretty easy to integrate with Angular with a simple service:

var module = angular.module( "app", [] );

module.factory( "cookies", function() {
  return Cookies.noConflict();
});

The ".noConflict()" method is used only in browser environments that load Cookies as a global variable. It is not necessary in UMD or AMD environments (they don't expose the .noConflict() method). In this case you just need to include js.cookie.js before angular.js.

Due to the nature of the "converter" API it is also possible to easily create specific instances for each use-case (The implementation below was taken from the write-converters PR):

module.factory( "phpCookies", function() {
  return Cookies
    .noConflict()
    .withConverter(function( value, name ) {
      return value
            // Decode all characters according to the "encodeURIComponent" spec
            .replace(/(%[0-9A-Z]{2})+/g, decodeURIComponent)
            // Decode the plus sign to spaces
            .replace(/\+/g, ' ')
    });
});

The usage would be something like this:

module.service( "customDataStore", [ "phpCookies", function( phpCookies ) {
  this.storeData = function( data ) {
    phpCookies.set( "data", data );
  };
  this.containsStoredData = function() {
    return phpCookies.get( "data" );
  }
}]);

It might be worth documenting this somewhere, including any other framework integration that might leverage the way this API was designed.

[FagnerMartinsBrack]

I created a wiki page for this: https://github.com/js-cookie/js-cookie/wiki/Integration-with-Angular-1.x