浅析Vue如何在页面刷新时保留状态信息

 更新时间:2026年04月29日 08:52:25   作者:蜡台  
本文介绍了Vuex状态持久化的两种方案,重点解决了iOS端Safari浏览器中的兼容性问题,文中的示例代码讲解详细,有需要的小伙伴可以参考一下

1、通过本地存储 state中的数据,页面刷新成功后再次从本地存储中读取state数据

//  vuex中的数据发生改变时触发localStorage的存储操作
localstorage.setItem('state', JSON.stringify(this.$store.state))

//  页面加载的时候在created中获取本地存储中的数据
localStorage.getItem('state') && this.$store.replaceState(JSON.parse(localStorage.getItem('state')));

注意:该操作会频繁的触发localStorage的存取工作

2、 监听页面刷新,触发存取操作

首先在入口组件App.vue中的created中利用localstorage或者sessionStorage来存取state中的数据

//   在页面加载时读取sessionStorage里的状态信息

if ( sessionStorage.getItem('state') ) {
  this.$store.replaceState( Object.assign( {}, this.$store.state,
  JSON.parse(sessionStorage.getItem('state') ) ) )
}

//   页面刷新时将state数据存储到sessionStorage中

window.addEventListener('beforeunload',()=>{
  sessionStorage.setItem('state',JSON.stringify(this.$store.state) )
})

注意:Object.assign() 方法用于将所有可枚举属性的值从一个或多个源对象复制到目标对象。它将返回目标对象

vuex状态保留

到这里,我们在PC端、安卓端、mac端safair浏览器中均能正常访问,但是在ios端的safair浏览器中存在问题,页面刷新后拿不到数据。

原因:在ios端beforeunload方法未执行,造成state数据未存储到本地,通过查询ios官方文档,文档中说unload和beforeunload已经废弃,使用pagehide作为代替

window.addEventListener('pagehide', () => {
     sessionStorage.setItem('state', JSON.stringify(this.$store.state))
   })

这样一番改动后,果然在PC端、安卓端、ios端均未出现问题

会话历史事件

  • pageshow事件:在用户访问页面时触发;pageshow 事件类似于 onload 事件,onload 事件在页面第一次加载时触发, pageshow 事件在每次加载页面时触发,即 onload 事件在页面从浏览器缓存中读取时不触发。
  • pagehide事件:在用户离开当前网页时触发;pagehide 事件有时可以替代 unload事件,但 unload 事件触发后无法缓存页面。

方法补充

在 Vue 应用中,页面刷新会导致浏览器重新加载整个应用,内存中的响应式数据(如 Vuex 或 Pinia 中的状态)会被清空。要保留状态信息,必须将数据持久化到物理存储中,最常用的是 localStorage 或 sessionStorage

下面介绍几种常见且高效的实现方式。

手动使用 localStorage 存储/恢复关键状态

适用于简单场景,仅需持久化少量数据。

// 在 store 或组件中
export default {
  data() {
    return {
      myState: JSON.parse(localStorage.getItem('myState')) || '默认值'
    }
  },
  watch: {
    myState: {
      handler(newVal) {
        localStorage.setItem('myState', JSON.stringify(newVal))
      },
      deep: true
    }
  },
  created() {
    // 也可在 created 钩子中读取
    const saved = localStorage.getItem('myState')
    if (saved) this.myState = JSON.parse(saved)
  }
}

缺点:每个状态都需要手动监听和序列化,工程量大。

Vuex + vuex-persistedstate 插件

Vuex 官方推荐,自动将整个或部分 state 同步到 localStorage。

1. 安装

npm install vuex-persistedstate

2. 在 store 中使用

import Vue from 'vue'
import Vuex from 'vuex'
import createPersistedState from 'vuex-persistedstate'

Vue.use(Vuex)

export default new Vuex.Store({
  state: {
    userInfo: null,
    token: '',
    theme: 'light'
  },
  mutations: {
    setUserInfo(state, info) { state.userInfo = info },
    setToken(state, token) { state.token = token },
    setTheme(state, theme) { state.theme = theme }
  },
  plugins: [
    createPersistedState({
      // 可选配置
      key: 'my-app-state',          // 存储的 key
      paths: ['userInfo', 'theme'], // 仅持久化这两个字段(不保存 token 等敏感信息)
      storage: window.localStorage  // 默认 localStorage
    })
  ]
})

页面刷新后,Vuex 会自动从 localStorage 读取数据并恢复到 state 中。

注意:避免将敏感信息(如 token、密码)持久化到 localStorage,以防 XSS 攻击。

Pinia + pinia-plugin-persistedstate 插件

Pinia 是 Vue 新一代的状态管理库,同样有官方持久化插件。

1. 安装

npm install pinia-plugin-persistedstate

2. 启用插件

// store/index.js
import { createPinia } from 'pinia'
import piniaPluginPersistedstate from 'pinia-plugin-persistedstate'

const pinia = createPinia()
pinia.use(piniaPluginPersistedstate)
export default pinia

3. 在 store 中配置持久化

// stores/user.js
import { defineStore } from 'pinia'

export const useUserStore = defineStore('user', {
  state: () => ({
    userInfo: null,
    token: '',
    theme: 'light'
  }),
  actions: {
    setUserInfo(info) { this.userInfo = info },
    setToken(token) { this.token = token }
  },
  persist: {
    key: 'user-store',        // 存储的 key
    paths: ['userInfo', 'theme'], // 只持久化这两个字段
    storage: localStorage      // 可选 sessionStorage
  }
})

无需额外代码,页面刷新后 store 状态自动恢复。

使用 sessionStorage 区别对待

  • localStorage:持久化存储,除非手动清除,否则一直存在。
  • sessionStorage:仅在当前标签页会话期间有效,关闭标签页即清除。

可根据业务需求选择,例如用户登录信息用 sessionStorage,主题设置用 localStorage。

// 手动写法
sessionStorage.setItem('key', value)
let val = sessionStorage.getItem('key')

// 插件中修改 storage 参数
createPersistedState({ storage: window.sessionStorage })

注意事项与最佳实践

安全性

  • 不要存储用户密码、支付密码等绝对敏感信息。
  • 若存储 token,请配合后端刷新机制并设置短过期时间,避免长期泄露风险。

性能

  • 避免持久化大型对象(如列表数据),会导致存储占用过高且序列化/反序列化耗时。
  • 对于大数据,可考虑 IndexedDB。

兼容性

  • localStorage 容量约 5~10MB,超出会报错。
  • 部分隐私模式可能禁用 localStorage,需做降级处理(如内存存储)。

版本管理:当存储的数据结构发生变化时,可在 created 或插件中做迁移清理,避免旧数据导致错误。

总结

方案适用规模代码侵入性推荐度
手动 localStorage单个组件、少量状态高(需手动 watch)⭐⭐
Vuex + vuex-persistedstate中大型 Vue 2/3 项目低(插件配置)⭐⭐⭐⭐
Pinia + pinia-plugin-persistedstateVue 3 + Pinia 项目极低(声明式)⭐⭐⭐⭐⭐

对于现代 Vue 3 项目,推荐使用 Pinia + 持久化插件,代码最简洁,维护成本最低。

到此这篇关于浅析Vue如何在页面刷新时保留状态信息的文章就介绍到这了,更多相关Vue状态持久化内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue项目通过a标签下载图片至zip包的示例代码

    vue项目通过a标签下载图片至zip包的示例代码

    在vue项目中,将图片下载可使用流的形式,下载成单个图片,或者将多个图片下载至zip包,本文就是介绍使用a标签下载图片的用法,文中有详细的代码示例供大家参考,具有一定的参考价值,需要的朋友可以参考下
    2023-10-10
  • Vue实现简单基础的图片裁剪功能

    Vue实现简单基础的图片裁剪功能

    这篇文章主要为大家详细介绍了如何利用Vue2实现简单基础的图片裁剪功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起了解一下
    2022-09-09
  • Vue.js展示AJAX数据简单示例讲解

    Vue.js展示AJAX数据简单示例讲解

    当通过AJAX方式取回数据后,使用vue.js可以完美地按一定逻辑在页面上的展示数据,代码简单、优美、自然,而且便于与在用的页面框架集成,本文给大家介绍Vue.js展示AJAX数据简单示例
    2017-03-03
  • Vue必学知识点之forEach()的使用

    Vue必学知识点之forEach()的使用

    在前端开发中,经常会遇到一些通过遍历循环来获取想要的内容的情形,这时候就需要用到forEach()了,下面这篇文章主要给大家介绍了关于Vue必学知识点之forEach()使用的相关资料,需要的朋友可以参考下
    2021-05-05
  • JointJS流程图的绘制方法

    JointJS流程图的绘制方法

    这篇文章主要为大家介绍了JointJS流程图的绘制方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-12-12
  • 详解keep-alive组件缓存

    详解keep-alive组件缓存

    keep-alive是Vue中一个非常有用的特性,它可以帮助我们避免重复渲染和减少组件的渲染次数,从而提高应用程序的性能,本文给大家介绍keep-alive组件缓存的相关知识,感兴趣的朋友一起看看吧
    2024-01-01
  • Vue.js实现日历功能

    Vue.js实现日历功能

    这篇文章主要为大家详细介绍了Vue.js实现日历功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-08-08
  • 在Vue项目中配置postcss-preset-env的两种主流方案

    在Vue项目中配置postcss-preset-env的两种主流方案

    在 Vue 项目中配置 postcss-preset-env,根据你使用的构建工具不同,配置方式也有所区别,以下是 Vue CLI (Webpack) 和 Vite 两种主流方案的详细配置,需要的朋友可以参考下
    2026-04-04
  • elementUI vue this.$confirm 和el-dialog 弹出框 移动 示例demo

    elementUI vue this.$confirm 和el-dialog 弹出框 移动 示例demo

    这篇文章主要介绍了elementUI vue this.$confirm 和el-dialog 弹出框 移动 示例demo,本文通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-07-07
  • vue单页面实现当前页面刷新或跳转时提示保存

    vue单页面实现当前页面刷新或跳转时提示保存

    这篇文章主要介绍了vue单页面实现当前页面刷新或跳转时提示保存,在当前页面刷新或跳转时提示保存并可取消刷新,以防止填写的表单内容丢失,感兴趣的小伙伴们可以参考一下
    2018-11-11

最新评论