Storage.setItem()
Storage
接口的 setItem()
方法,当传递了一个键名和值时,将会把键名添加到给定的 Storage
对象中,如果键名已存在,则更新其对应的值。
语法
js
setItem(keyName, keyValue)
参数
keyName
-
包含要创建或更新的键名字符串。
keyValue
-
包含要创建或更新的键名对应的值字符串。
返回值
无 undefined
。
异常
在存储已满的情况下,调用 setItem()
可能会抛出异常。开发人员应始终捕获 setItem()
可能抛出的异常。
示例
下面的函数在本地存储中创建三个数据项。
js
function populateStorage() {
localStorage.setItem("bgcolor", "red");
localStorage.setItem("font", "Helvetica");
localStorage.setItem("image", "myCat.png");
}
备注: 有关实际运行的例子,详见 Web Storage 演示。
规范
Specification |
---|
HTML Standard # dom-storage-setitem-dev |
浏览器兼容性
BCD tables only load in the browser