Skip to content
Have a brief look

浏览器本地存储 Web Storage

浏览器本地存储

浏览器本地存储包括两个对象:sessionStoragelocalStorage,它们都是 Storage 的实例对象。

js
window.localStorage instanceof Storage // true

基本使用

访问数据:getItem()

添加、修改数据:setItem()

删除数据:removeItem()

清空数据:clear()

获取给定位置的键名:key()

js
// 以 localStorage 为例,sessionStorage 都一样
// 添加数据
localStorage.setItem('name', 'BruceBlog')
localStorage.setItem('age', 2333)

// 修改数据
localStorage.setItem('age', 520)

// 读取数据
localStorage.getItem('age')

// 删除数据
localStorage.removeItem('name')

// 清空数据
localStorage.clear()

// 遍历所有值,不知道是按什么顺序排列的
for (let i = 0; i < localStorage.length; i++) {
  let key = localStorage.key(i)
  let value = localStorage.getItem(key)
  console.log(`key: ${key}, value: ${value}`)
}

注意事项

只能够存储字符串,不是字符串的会调用 toString() 方法转成字符串。

如果想要存储对象,需要使用 JSON.stringify() 转成 JSON 字符串再存储,以后再用 JSON.parse() 还原成对象。

如果无法转成字符串,则会报错。比如 Symbol 类型的变量无法转成字符串。

js
let obj = { book: 'HTTP', price: 46 }
let obj2 = {}
function fn() {}

localStorage.setItem(obj, 'object') // '[object Object]': 'object'
localStorage.setItem('func', fn) // 'func': 'function fn() {}'

localStorage.setItem('info', JSON.stringify(obj)) // 'info': '{\"book\":\"HTTP\",\"price\":46}'

localStorage.getItem(obj2) // 'object',obj2 会被转成 '[object Object]'

localStorage.setItem('symbol', Symbol(666)) // Uncaught TypeError: Cannot convert a Symbol value to a string

sessionStoragelocalStorage 对比

sessionStorage 是跨会话存储机制,localStorage 是永久存储机制。

作用时间:sessionStorage 在窗口关闭后就会失效,localStorage 是永久存储,除非手动通过 JS 删除或清除浏览器缓存。

作用范围:sessionStorage 的数据只能在同源(协议域名端口号相同)、同一个窗口共享,localStorage 的数据在同源、不同窗口共享(同一个浏览器)

If there is any reprint or CV, please mark the original address of this website