大网数据广告活动
Web 标准与前端开发

Storage.setItem()

· 52CE 我爱测

Storage 接口的 **`setItem()`** 方法,当传递了一个键名和值时,将会把键名添加到给定的 `Storage` 对象中,如果键名已存在,则更新其对应的值。

Web Storage API

Storage 接口的 setItem() 方法,当传递了一个键名和值时,将会把键名添加到给定的 Storage 对象中,如果键名已存在,则更新其对应的值。

语法

setItem(keyName, keyValue)

参数

  • keyName
    • : 包含要创建或更新的键名字符串。
  • keyValue
    • : 包含要创建或更新的键名对应的值字符串。

返回值

无 undefined。

异常

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

示例

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

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

[!NOTE] 有关实际运行的例子,详见 Web Storage 演示。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。