Storage.setItem()

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

语法

storage.setItem(keyName, keyValue);

参数

keyName

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

keyValue

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

返回值

异常

在存储已满的情况下,调用 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

参见