Storage.setItem()

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

语法

storage.setItem(keyName, keyValue);

参数

keyName

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

keyValue

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

返回值

undefined。

异常

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

示例

下面的函数在本地存储中创建三个数据项。

function populateStorage() {
  localStorage.setItem('bgcolor', 'red');
  localStorage.setItem('font', 'Helvetica');
  localStorage.setItem('image', 'myCat.png');
}

备注： 一个实际的例子：Web Storage Demo。

规范

Specification
HTML Standard
# dom-storage-setitem-dev

浏览器兼容性

BCD tables only load in the browser

参见