BOM系列之localStorage

---

1、属性

1.1、length

1.1.1、概述

length 是 localStorage 接口的只读属性，返回一个整数，表示存储在 localStorage 对象里的数据项（data items）数量。

1.1.2、语法

var aLength = localStorage.length;

1.1.3、返回值

一个整数

2、方法

2.1、存储数据

2.1.1、概述

localStorage 接口的 setItem() 方法，接受一个键名和值作为参数，将会把键名添加到给定的 localStorage 对象中，如果键名已存在，则更新其对应的值。

2.1.2、语法

localStorage.setItem(keyName, keyValue);

2.1.3、参数

• keyName

一个 DOMString，表示要创建或更新的键名。

• keyValue

一个 DOMString，表示要创建或更新的键名对应的值。

2.1.4、返回值

undefined

2.1.5、异常

在存储已满的情况下，调用 setItem() 可能会抛出异常。开发人员应始终捕获 setItem() 可能抛出的异常。

2.2、获取数据

2.2.1、概述

getItem() 作为 localStorage 接口的方法，接受一个键名（key name）作为参数，并返回对应键名的值（key’s value）。

2.2.2、语法

var aValue = localStorage.getItem(keyName);

2.2.3、参数

• keyName

一个包含键名的 DOMString。

2.2.4、返回值

一个 DOMString，键名对应的值。如果键名不存在于存储中，则返回 null。

2.3、删除数据

2.3.1、概述

localStorage 接口的 removeItem() 方法，接受一个键名作为参数，会从给定的 localStorage 对象中删除该键名（如果存在）。 如果没有与该给定键名匹配的项，则此方法将不执行任何操作。

2.3.2、语法

localStorage.removeItem(keyName);

2.3.3、参数

• keyName

一个 DOMString，即你想要移除的键名。

2.3.4、返回值

无

2.4、清空数据（所有都清除掉）

2.4.1、概述

clear() 是 localStorage 接口的一个方法，调用它可以清空存储对象里所有的键值。

2.4.2、语法

localStorage.clear();

2.4.3、参数

无

2.4.4、返回值

无

2.5、键

2.5.1、概述

key() 作为 localStorage 接口的方法，接受一个数值 n 作为参数，返回存储对象第 n 个数据项的键名。键的存储顺序是由用户代理定义的，所以尽可能不要依赖这个方法。

2.5.2、语法

var aKeyName = localStorage.key(key);

2.5.3、参数

• key

一个整数，表示要获取的键名索引。

2.5.4、返回值

一个包含键名的 DOMString。

---

后记

如果你感觉文章不咋地//(ㄒoㄒ)//，就在评论处留言，作者继续改进；o_O???
如果你觉得该文章有一点点用处，可以给作者点个赞；\\*^o^*//
如果你想要和作者一起进步，可以微信扫描二维码，关注前端老L；~~~///(^v^)\\\~~~
谢谢各位读者们啦(^_^)∠※！！！