About

This script is implemented in imitation of js-cookie, which is a useful javascript API.

Installation

1. Download the script here.
2. use the command npm i -d myl-storage.js in npm.

Basic Usage

create a storage, specifying the type one of cookie, localStorage and sessionStroage.

var c = storage("cookie"); // cookie
var l = storage("localStorage"); // localStorage 
var s = storage("sessionStorage"); // sessionStorage

This script supports some common approaches defined in storage.prototype, and now uses cookie storage as an example.

var c = storage("cookie"); // cookie storage
c.set("a", "1"); // set a key-value "a: 1" in cookie
c.get("a"); // get the value of key "a" in cookie
c.remove("a"); // remove the key "a" in cookie

Alternatively, you can also use the methods as follow:

var c = storage("cookie");
c.setItem("a", "1"); // like set method
c.getItem("a", "1"); // like get method
c.removeItem("a"); // like remove method
c.all(); // Returns an object with all key-value pairs in cookie
c.clear(); // clear all key-value pairs in cookie

When you using a cookie storage, you can add a object param in set or setItem method to certain the cookie's options, such as path and so on.

var c = storage("cookie");
c.set("a", "1", {
    path: "/"
});

Extension

You can extend or override storage methods by using extend or override methods

common method

Use the following code to change common method defined in storage.prototype

storage.prototype.extend("fun", function() {});
storage.prototype.override("fun", function(){});

personal method

Use the following code to change personal method defined in cookie storage, session storage or local storage.

var c = storage("cookie");
c.extend("fun", function(){});
c.override("fun", function(){});

In addition, the object created by storage() is a simple object, but not document.cookie、window.localStorage and window.sessionStorage.
When you extend or override the function, you can use document.cookie to get the cookie of document, use window.localStorage or this__proto__ to get the localStorage of window and the usage of session storage is the same as local storage.
Examples:

// cookie storage
var c = storage("cookie");
c.extend("getCookieStr", function() {
    return document.cookie;
});

// local storage
var l = storage("localStorage");
l.extend("getAttrs", function() {
    // get window.localStorage
    var localStorage = this.__proto__;
    var arr = [];
    for(var key in localStorage) {
        if(localStorage.hasOwnProperty(key) && typeof localStorage[key] !== "function" && key !== "length") {
            arr.push(localStorage[key]);
        }
    }
    return arr;
});

Conflict

You can use noConflict method to eliminate naming conflict.

var myStorage = storage.noConflict();
var c = myStorage("cookie");