通用的緩存模塊, 支持cookie, localStorage, sessionStorage。

只能在支持ES5的瀏覽器(>=IE9)上使用。

快速開始

如果引入了jQuery, 則該模塊將附加到jQuery上, 否則直接附加到window對象上。

// 已引入jQuery的情況
$.Cache.set('user', {
    id: 10,
    name: '王重陽'
}, 0);

console.log($.Cache.get('user'));

/** outputs:
{
    id: 10,
    name: '王重陽'
}
*/

// 未引入jQuery的情況
Cache.set('user', {
    id: 10,
    name: '王重陽'
}, 0);

console.log(Cache.get('user'));

/** outputs:
{
    id: 10,
    name: '王重陽'
}
*/

屬性

appId

緩存唯一應用標記, 用于區分不同網站。

version

緩存版本標記, 用于強制用戶已有緩存失效。

方法

set(key, value, expire, options)

寫入緩存, 參數說明如下:

key

鍵名, 緩存參數名稱

value

鍵值, 緩存內容, 可以是: 字符串、數字、布爾值、數組、json

expire

過期時間, 該參數情況比較復雜, 說明如下:

• 如果未指定該參數(undefined), 則緩存為sessionStorage

• 如果參數為數字, 則為到期時間的時間戳

• 如果參數為0, 則表示永不過期

• 如果參數為字符串, 則表示緩存的有效時間, 如: 1y表示一年, 可以用的時間單位有y(年)、m(月)、d(日)、h(時)、n(分)、s(秒)

options

如果指定該參數(不為undefined), 則表示使用cookie存儲

• options.path: cookie存儲的path, 默認為'/'
• options.cross: 是否允許跨子域, 默認為true

get(key)

讀取指定緩存， 按照先cookie -> localStorage -> sessionStorage的順序自動讀取。

remove(key)

刪除指定緩存，該方法將刪除cookie、localStorage和sessionStorage中所有匹配的緩存數據。

clear()

清空緩存，該方法將清空cookie、localStorage和sessionStorage中所有以appId開頭的緩存數據。