HTML5 本地存储 localStorage、sessionStorage 的遍历、存储大小限制处理

目录
[隐藏]

HTML5 的本地存储 API 中的 localStorage 与 sessionStorage 在使用方法上是相同的,区别在于 sessionStorage 在关闭页面后即被清空,而 localStorage 则会一直保存。我们这里以 localStorage 为例,简要介绍下 HTML5 的本地存储,并针对如遍历等常见问题作一些示例说明。 localStorage 是 HTML5 本地存储的 API,使用键值对的方式进行存取数据,存取的数据只能是字符串。不同浏览器对该 API 支持情况有所差异,如使用方法、最大存储空间等。

1. localStorage API 基本使用方法

localStorage API 使用方法简单易懂,如下为常见的 API 操作及示例:

设置数据:localStorage.setItem(key,value);。示例:

for(var i = 0; i < 10; i++) {
    localStorage.setItem(i, i);
}

获取数据:localStorage.getItem(key)

获取全部数据:localStorage.valueOf()。示例:

for(var i = 0; i < 10; i++){
    localStorage.getItem(i);
}

删除数据:localStorage.removeItem(key) 。示例:

for(var i=0; i<5; i++){
    localStorage.removeItem(i);
}

清空全部数据:localStorage.clear()

获取本地存储数据数量:localStorage.length

获取第 N 个数据的 key 键值:localStorage.key(N)

2. 遍历 key 键值方法

for(var i = localStorage.length - 1; i >= 0; i--){
    console.log('第'+ (i+1) +'条数据的键值为:' + localStorage.key(i) +',数据为:' + localStorage.getItem(localStorage.key(i)));
}

3. 存储大小限制测试及异常处理

3.1 数据存储大小限制测试

不同浏览器对 HTML5 的本地存储大小基本均有限制,一个测试的结果如下:

IE 9          > 4999995 + 5 = 5000000
firefox 22.0 > 5242875 + 5 = 5242880
chrome  28.0  > 2621435 + 5 = 2621440
safari  5.1   > 2621435 + 5 = 2621440
opera   12.15 > 5M (超出则会弹出允许请求更多空间的对话框)

获取当前 localStorage / sessionStorage 存储数据的大小:

function getStorageSize(type = 'local') {
    const stor = type === 'session' ? sessionStorage : localStorage;
    let size = 0;

    for (let i in stor) {
        if (!stor.hasOwnProperty(i)) continue;
        size += stor.getItem(i).length;
    }

    return size;
}

测试代码参考:

点我去测试

<!DOCTYPE html>
<html>
<head>
<script>
    function log( msg ) {
        console.log(msg);
        alert(msg);
    }

    var limit;

    var half = '1'; //这里会换成中文再跑一遍
    var str = half;
    var sstr;

    while ( 1 ) {
        try {
            localStorage.clear();
            str += half;
            localStorage.setItem( 'cache', str );
            half = str;
        } catch ( ex ) {
            break;
        }
    }

    var base = str.length;
    var off = base / 2;
    var isLeft = 1;

    while ( off ) {
        if ( isLeft ) {
            end = base - (off / 2);
        } else {
            end = base + (off / 2);
        }

        sstr = str.slice( 0, end );
        localStorage.clear();
        try {
            localStorage.setItem( 'cache', sstr );
            limit = sstr.length;
            isLeft = 0;
        } catch ( e ) {
            isLeft = 1;
        }

        base = end;
        off = Math.floor( off / 2 );
    }

    log( 'limit: ' + limit );

</script>
</html>

3.2 数据存储异常处理

try {
    localStorage.setItem(key,value);
} catch(oException) {
    if(oException.name === 'QuotaExceededError') {
        console.log('超出本地存储限额!');
        //如果历史信息不重要了,可清空后再设置
        localStorage.clear();
        localStorage.setItem(key,value);
    }
}
点赞 (15)
  1. s说道:
    Google Chrome 53.0.2785.116 Google Chrome 53.0.2785.116 Mac OS X  10.10.5 Mac OS X 10.10.5

    请问 这个容量限制是指 整个浏览器总的localstrorage 容量 还是每个网站单个的限制在5m左右?

    1. 任侠说道:
      Google Chrome 52.0.2743.116 Google Chrome 52.0.2743.116 Mac OS X  10.11.6 Mac OS X 10.11.6

      每个站点,以域名区分

  2. 123说道:
    Firefox 40.0 Firefox 40.0 Windows 7 x64 Edition Windows 7 x64 Edition

    :twisted: :roll: :wink: :arrow: :cry: :???:

  3. 114博客大全说道:
    Sogou Explorer Sogou Explorer Windows 7 Windows 7

    拜访,网站不错!欢迎加入114博客大全

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

Captcha Code