使用localstorage缓存ajax,插件 jQuery-ajax-localstorage-cache 中文API文档

插件 jquery-ajax-localstorage-cache 中文API文档

源码 & 下载

适用场景

使用浏览器的本地存储或任何与存储接口兼容的对象存储ajax响应

插件特点

使用浏览器的本地存储或任何与存储接口兼容的对象存储ajax响应,jquery-ajax-localstorage-cache - 从这里缩写 Jalc

Jalc是为jQuery构建的插件(对于1.xx为> = 1.5.1,对于2.xx为> = 3.0.0)以及实现存储接口的任何对象 ,例如 localStorage,为AJAX响应提供客户端缓存旨在节省带宽和时间。

基本用法

$.ajax({

url: '/post',

localCache: true, // 必需。布尔值,在这种情况下将使用localStorage,或实现存储接口的对象

cacheTTL: 1, // 可选。可以与float一起使用来指示一小时的一部分,例如 0.5

cacheKey: 'post', // 可选.

isCacheValid: function () { // 可选.

return true;

},

isResponseValid: function (data, status, jqXHR) { // 可选.

return data.code === '0';

},

thenResponse: function (data, status, jqXHR) { // 可选,仅在版本2.x.x + 中以任何方式更改数据,以便在缓存之前对其进行更改。

data.code = 101;

return data;

}

}).done(function (response) {

//响应

});

官方介绍

在您的AJAX请求中,您将获得6个新参数:

localCache

打开/关闭localCache,或指定实现要使用的存储接口的对象。

默认值:false

cacheTTL

缓存值应以多小时(以小时计)被视为有效。

浮动可用于指示一小时的某些部分,例如0.5指示半小时。

适用于指定/计算的cacheKey - 每个缓存对象都会尊重它自己的cacheTTL,所有缓存对象都没有“全局”TTL计时器。

默认值:5小时

cacheKey

CacheKey是用于在localStorage中存储响应的密钥。

回调函数也可用于返回动态生成的cacheKey。Ajax选项被传递给此回调,但请记住,该函数需要返回一个稳定的cacheKey - 也就是说,对于给定的一组参数,该函数应始终返回相同的生成的cacheKey。

默认值:URL + TYPE(GET / POST)+ DATA(强制转换为字符串)

isCacheValid

此函数必须返回true或false。如果为false,则删除缓存的响应。

默认值:null

isResponseValid

此函数必须返回’truthy’值(布尔值,或可强制转换为布尔值)。在falsey时,不缓存来自服务器的响应。

默认值:null

thenResponse

此函数必须返回要传递给下一个then或done块的数据。允许您指定一个函数,该函数将在缓存并返回数据之前以某种方式更改数据。请记住,只有从远程获取时才会从缓存中获取此函数,因此不要依赖它来执行每次进行ajax调用时要进行的转换 - 这些应该改为在then你的ajax请求块中。

默认值:null

注意

您可以使用localStorage.clear(),或者localStorage.removeItem(‘cacheKey’) 如果指定了cacheKey ,则可以删除缓存。请注意,上面假设您使用的是localStorage - 根据您的存储接口实现对象进行替换。

您可以使用此插件预加载内容。您只需要使用相同的cacheKey执行初始AJAX请求。

在大多数情况下,您可以依赖于dataType jQuery ajax参数的“智能猜测” ,并且不使用dataType参数,插件将存储从服务器返回的内容类型以及数据。但是,如果在ajax参数中明确指定dataType,则会获得更一致的结果。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值