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.
``js
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.
`js
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:
`js
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.
`js
var c = storage("cookie");
c.set("a", "1", {
path: "/"
});
`

Extension

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

$3

Use the following code to change common method defined in storage.prototype
`js
storage.prototype.extend("fun", function() {});
storage.prototype.override("fun", function(){});
`

$3

Use the following code to change personal method defined in cookie storage, session storage or local storage.
`js
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:
`js
// 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.
`js
var myStorage = storage.noConflict();
var c = myStorage("cookie");
``