共计 2290 个字符，预计需要花费 6 分钟才能阅读完成。
提醒：本文最后更新于2024-10-22 11:54，文中所关联的信息可能已发生改变，请知悉！
HTML5 的本地存储 API 中的 localStorage 与 sessionStorage 在使用方法上是相同的，区别在于 sessionStorage 在关闭页面后即被清空，而 localStorage 则会一直保存。我们这里以 localStorage 为例，简要介绍下 HTML5 的本地存储，并针对如遍历等常见问题作一些示例说明。 localStorage 是 HTML5 本地存储的 API，使用键值对的方式进行存取数据，存取的数据只能是字符串。不同浏览器对该 API 支持情况有所差异，如使用方法、最大存储空间等。
1. localStorage API 基本使用方法
localStorage API 使用方法简单易懂，如下为常见的 API 操作及示例：
设置数据：localStorage.setItem(key,value);。示例：
[code lang=js]
for(var i = 0; i < 10; i++) {
localStorage.setItem(i, i);
}
[/code]
获取数据：localStorage.getItem(key)
获取全部数据：localStorage.valueOf()。示例：
[code lang=js]
for(var i = 0; i < 10; i++){
localStorage.getItem(i);
}
[/code]
删除数据：localStorage.removeItem(key) 。示例：
[code lang=js]
for(var i=0; i<5; i++){
localStorage.removeItem(i);
}
[/code]
清空全部数据：localStorage.clear()
获取本地存储数据数量：localStorage.length
获取第 N 个数据的 key 键值：localStorage.key(N)
2. 遍历 key 键值方法
[code lang=js]
for(var i = localStorage.length – 1; i >= 0; i–){
console.log('第'+ (i+1) +'条数据的键值为：' + localStorage.key(i) +'，数据为：' + localStorage.getItem(localStorage.key(i)));
}
[/code]
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 存储数据的大小：
[code lang=js]
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;
}
[/code]
测试代码参考：
[code lang=html]
<!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>
[/code]
3.2 数据存储异常处理
[code lang=js]
try {
localStorage.setItem(key,value);
} catch(oException) {
if(oException.name === 'QuotaExceededError') {
console.log('超出本地存储限额！');
//如果历史信息不重要了，可清空后再设置
localStorage.clear();
localStorage.setItem(key,value);
}
}
[/code]
Google Chrome 53.0.2785.116 
Mac OS X 10.10.5
Firefox 40.0 
Windows 7 x64 Edition
:arrow: 
Sogou Explorer