Window localStorage 属性

定义和用法

localStorage 和 sessionStorage 属性允许在 Web 浏览器中保存键/值对。

localStorage 对象存储没有到期日期的数据。浏览器关闭时数据不会被删除,并且会在第二天、周或一年后可用。

localStorage 属性是只读的。

提示:还请参阅 sessionStorage 属性,该属性存储一个会话的数据(关闭浏览器选项卡时数据会丢失)。

实例

例子 1

创建一个 name="lastname" 和 value="Smith" 的 localStorage 名称/值对,然后检索 "lastname" 的值并将其插入到 id="result" 的元素中:

// 存储
localStorage.setItem("lastname", "Smith");
// 取回
document.getElementById("result").innerHTML = localStorage.getItem("lastname");

亲自试一试

例子 2

下面的例子计算用户单击按钮的次数:

if (localStorage.clickcount) {
  localStorage.clickcount = Number(localStorage.clickcount) + 1;
} else {
  localStorage.clickcount = 1;
}
document.getElementById("result").innerHTML = "You have clicked the button " +
localStorage.clickcount + " time(s).";

亲自试一试

语法

window.localStorage

向 localStorage 保存数据的语法:

localStorage.setItem("key", "value");

从 localStorage 读取数据的语法:

var lastname = localStorage.getItem("key");

从 localStorage 删除数据的语法:

localStorage.removeItem("key");

技术细节

返回值: Storage 对象

浏览器支持

表中的数字指定了完全支持该属性的首个浏览器版本。

属性 Chrome IE Firefox Safari Opera
localStorage 4.0 8.0 3.5 4.0 11.5