Storage setItem() 方法

JavaScript Storage 对象

setItem()方法在给定的存储对象中设置指定键名的值,如果该键值已经存在,则更新该键值。

setItem()方法属于存储对象,可以是localStorage对象或sessionStorrage对象。

语法:

localStorage.setItem(key, value)
sessionStorage.setItem(key, value)
localStorage.setItem('color', 'green');
localStorage.setItem('image', 'parrot.png');
localStorage.setItem('url', '');
测试看看‹/›

浏览器兼容性

表格中的数字指定了完全支持setItem()方法的第一个浏览器版本:

Method
setItem()43.511.549

参数值

参数描述
key包含您要创建/更新的键名称的字符串
value包含要提供要创建/更新的键的值的字符串

技术细节

返回值:一个字符串,表示插入的值
DOM版本:网络存储API

更多实例

设置指定的会话存储项的值:

sessionStorage.setItem('time', Date.now());
sessionStorage.setItem('age', 22);
测试看看‹/›

您还可以使用点表示法设置值:

localStorage.color = "green";
localStorage.image = "parrot.png";
localStorage.url = "";
测试看看‹/›

以下函数在本地存储中创建三个数据项,然后使用它们在页面上设置自定义样式:

function populateStorage() {
  localStorage.setItem('bgcolor', document.getElementById('bgcolor').value);
  localStorage.setItem('font', document.getElementById('font').value);
  localStorage.setItem('image', document.getElementById('image').value);
}
测试看看‹/›

相关参考

HTML教程:Web存储API

窗口(Window)参考:window.localStorage属性

窗口(Window)参考:window.sessionStorage属性

JavaScript Storage 对象