vue-router升级后遇到的问题

前言

最近公司需要把项目从vue2升级到vue3,路由也从vue-router从3升级到4版本,这种跨版本升级,很多写法都变了,api很多也不一定兼容,所以项目的功能都要重新测一遍,有问题的就要修改。

正文

路由模式

之前vue router的路由模式是下面这种写法:

js 复制代码
import Router from 'vue-router'
new Router({
  mode: 'hash', // history,abstract等
  base: process.env.BASE_URL,  // 取自于`vue.config.js` 中的 `publicPath`字段,等同
  routes
})

通过mode字段定义路由模式,然后base字段是基准路径。

而新的vue router4则更改了写法,提供一个history字段,值有以下:

  • createWebHashHistory(base)
  • createWebHistory(base)
  • createMemoryHistory(base)

分别对应之前的hash,history,abstract模式。

然后base字段也去掉了,改成直接通过传参来代替。

js 复制代码
import { createRouter, createWebHashHistory } from 'vue-router'
const router = createRouter({
  history: createWebHashHistory(process.env.BASE_URL),
  routes
})

同时,不再采用new Router实例化,而是采用createRouter调用函数,同时还暴露出createWebHashHistory,createWebHistory等函数。

mixins的router钩子函数

以前我们的组件会在mixins里面调用router的钩子函数,比如beforeRouteUpdate钩子函数,它会在路由改变,组件复用的时候调用。

在项目中,我们会在这个beforeRouteUpdate钩子函数里更新最新的参数。

但是我们在新的vue-router4里面,发现无论参数怎么变,请求还是之前的参数,导致数据还是老数据。

排查一番,才发现是mixins的钩子函数并没有执行,导致参数不能及时更新,导致请求还是老数据。

按理说这个逻辑应该跟之前的router版本一致才对,不应该出现这样的问题。

去github一搜索,发现这个问题一直存在,到现在还没有解决。

github的issue如下:

官方的回应:

同时我们在vue-router的文档中也可以看到,在从vue2中迁移

解决方案

第一种:

我们可以在组件定义一个router钩子函数,然后里面是执行mixins对应的钩子函数,并把参数传过去,mixins那边的逻辑不用改。这样改动相对较小。

示例代码:

js 复制代码
  import mixinsjs from '@/mixins/mixinsjs'
  export default {
    mixins: [minxinjs],
    beforeRouteUpdate (to, from, next) {
        minxinjs.beforeRouteUpdate.apply(this, [to, from, next])
    }
  }

第二种:

如果你的mixins只有这些钩子函数的逻辑,而且组件上没有这些钩子,可以采用解构的方法。

js 复制代码
 import mixinsjs from '@/mixins/mixinsjs'
 export default {
    ...minxinjs, // 解构
    // rest component logic 
 }

注意: 解构的方式,组件的data和methods会覆盖掉minxins的data,和methods,请注意解构的mixins中只有钩子函数的逻辑。

第三种:

可以在mixins中,定义一个created函数 ,利用this.$route的钩子守卫函数,把mixins中的router钩子逻辑写在对应的位置。

js 复制代码
const mixinsjs =  {
  created () {
    const route = this.$route.matched[0]
    if (!route) return
    route.leaveGuards = [function (to, from, next) {
      // beforeRouteLeave 的逻辑写在这里
      next()
    }]
    route.beforeEnter = [function (to, from, next) {
      // beforeRouteEnter 的逻辑写在这里
      next()
    }]
    route.updateGuards = [function (to, from, next) {
      // beforeRouteUpdate 的逻辑写在这里
      next()
    }]
  }
}
export default mixinsjs

总结

以上就是我升级vue-router后遇到的问题,vue-router这种跨大版本的升级,肯定会存在很多兼容问题,大家先评估改动的成本,再决定是否升级。

相关推荐
大怪v3 小时前
【搞发🌸活】不信书上那套理论!亲测Javascript能卡浏览器Reader一辈子~
javascript·html·浏览器
西陵4 小时前
Nx带来极致的前端开发体验——任务缓存
前端·javascript·架构
Panda__Panda4 小时前
docker项目打包演示项目(数字排序服务)
运维·javascript·python·docker·容器·c#
10年前端老司机5 小时前
Promise 常见面试题(持续更新中)
前端·javascript
nueroamazing6 小时前
PPT-EA:PPT自动生成器
vue.js·python·语言模型·flask·大模型·项目·ppt
WebDesign_Mu7 小时前
为了庆祝2025英雄联盟全球总决赛开启,我用HTML+CSS+JS制作了LOL官方网站
javascript·css·html
噢,我明白了8 小时前
前端js 常见算法面试题目详解
前端·javascript·算法
学编程的小虎8 小时前
用 Python + Vue3 打造超炫酷音乐播放器:网易云歌单爬取 + Three.js 波形可视化
开发语言·javascript·python
做好一个小前端8 小时前
后端接口获取到csv格式内容并导出,拒绝乱码
前端·javascript·html
LuckySusu9 小时前
【vue篇】Vue 项目中的静态资源管理:assets vs static 终极指南
前端·vue.js