Vue 重写push和replace方法,解决:Avoided redundant navigation to current location

文章讲述了在VueRouter中,当两次携带相同参数进行跳转时可能导致错误。作者通过重写VueRouter的push和replace方法,允许用户自定义回调函数,从而避免每次调用都必须写入回调,提高了代码可读性和便捷性。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

当我们使用编程式路由导航跳转路径时,如果我们两次携带同样的参数进行跳转,会进行页面报错:

那产生这个问题的原因是什么呢?

我们接收并输出调用push方法返回的结果:

会发现这是一个Promise对象 

我们都知道,我们在使用一个Promise对象是时候需要配置成功执行函数和失败回调函数,

所以我们只需要在使用push方法的时候额外传入一个成功回到函数和一个失败回调函数即可。

但是使用这种方法治标不治本,难道我们每一次调用push和replace都要额外写两个回调函数吗?

所以,为了书写便捷,我们可以重写push 方法和replace 方法:

首先我们需要搞清楚push方法在哪儿:

既然push方法是我们引入的vue-router中的方法,那么我们就去找创建$router 的实例对象

我们输出一下引入的VueRouter构造函数,会发现在其prototype下的push方法和replace方法

那么我们就对VueRouter.prototype.push 和 VueRouter.prototype.replace 进行重写。

在router 配置文件中编写如下代码即可:

// 引入router
import VueRouter from "vue-router";

// 保存一份原来的push 和 replace 方法
let originPush = VueRouter.prototype.push;
let originReplace = VueRouter.prototype.replace;

// 重写push方法
// push接受三个参数:配置项、成功回调函数、失败回调函数
VueRouter.prototype.push = function (location, resolve, reject) {
    // 如果用户自定义了成功回调函数和失败回调函数
    if (resolve && reject) {
        // 直接调用原方法,并传递用户配置的回调函数
        // 注意这里需要把originPush的指向改为VueRouter
        // 使用call方法能够调用函数一次,传递参数使用逗号隔开;apply方法使用数组隔开
        originPush.call(this, location, resolve, reject);
    } else {
        // 如果用户没有自定义回调函数,那么我们手动传入两个空函数
        originPush.call(this, location, () => {}, () => {});
    }
};

// 重写replace方法
VueRouter.prototype.replace = function (location, resolve, reject) {
    if (resolve && reject) {
        originReplace.call(this, location, resolve, reject);
    } else {
        originReplace.call(this, location, () => {}, () => {});
    }
}
<think>我们被要求解决Vue Router中导航重复到当前路径'/console'的问题。根据引用内容,这个错误通常发生在尝试使用`this.$router.push`或类似方法导航到当前已经激活的路由时。 解决方案有多种: 1. 在调用push方法时添加错误捕获,忽略NavigationDuplicated错误(如引用[1]所示)。 2.push方法中提供空函数作为错误处理(如引用[4]所示),但这样会忽略所有错误,可能不是最佳。 3. 另一种方法是在跳转前判断当前路由是否已经是目标路由,如果是则避免跳转。 我们还可以考虑其他方法,比如重写VueRouterpush方法,全局捕获并忽略NavigationDuplicated错误。 下面我将分别介绍这些方法方法一:在每次push时捕获特定错误 ```javascript this.$router.push('/console').catch(err => { if (err.name !== 'NavigationDuplicated') { throw err; // 如果不是NavigationDuplicated错误,则重新抛出 } }); ``` 方法二:在push方法中添加空回调(不推荐,因为会忽略所有错误) ```javascript this.$router.push('/console', () => {}, (error) => { // 这里可以只忽略NavigationDuplicated,但语法上这样写是传入两个回调(成功失败),但根据引用[4]的写法,实际上push方法在3.1.0之后返回Promise,所以使用catch更合适。 // 注意:push方法的参数形式有多种,如果使用两个回调函数的形式,则第一个是成功回调,第二个是失败回调。 // 但是,根据官方文档,push方法可以接受三个参数:location, onComplete?, onAbort?。所以可以这样写: }); // 或者 this.$router.push('/console', undefined, (error) => { if (error.name !== 'NavigationDuplicated') { // 处理其他错误 } }); ``` 方法三:在跳转前检查当前路由 ```javascript if (this.$route.path !== '/console') { this.$router.push('/console'); } ``` 注意:如果路径相同但查询参数或哈希不同,则$route.path相同但$route.fullPath可能不同。所以如果只比较path,那么当查询参数变化时也会被阻止。因此,如果需要考虑查询参数,应该使用fullPath。 方法四:全局重写router的push方法(推荐,一劳永逸) 在创建router实例后,重写push方法,捕获NavigationDuplicated错误并忽略。 ```javascript import VueRouter from 'vue-router'; const originalPush = VueRouter.prototype.push; VueRouter.prototype.push = function push(location, onResolve, onReject) { if (onResolve || onReject) { return originalPush.call(this, location, onResolve, onReject); } return originalPush.call(this, location).catch(err => { if (err.name !== 'NavigationDuplicated') { throw err; } }); }; ``` 这样,在整个应用中,每次调用push方法时都会自动捕获并忽略NavigationDuplicated错误。 根据引用[3][4],这个错误是由于vue-router在3.1.0版本之后引入了Promise,当重复导航且参数不变时会抛出错误。因此,上述方法都是可行的。 用户希望避免到路径'/console'的重复导航警告,我们可以根据具体情况选择方法。如果只是个别地方,使用方法一或三。如果是整个项目,方法四更合适。 现在,我们按照要求生成相关问题。</think>### Vue Router NavigationDuplicated 错误解决方案 当尝试重复导航到当前路径 `/console` 时,Vue Router 会抛出 `NavigationDuplicated` 错误。这是由于 vue-router 3.1.0+ 版本引入的 Promise 机制导致的[^2][^3][^4]。以下是完整解决方案: #### 1. **全局解决方案(推荐)** 在 router 实例中重写 `push` 方法,全局捕获错误: ```javascript // router/index.js import VueRouter from 'vue-router' const originalPush = VueRouter.prototype.push VueRouter.prototype.push = function push(location) { return originalPush.call(this, location).catch(err => { if (err.name !== 'NavigationDuplicated') throw err }) } ``` #### 2. **局部解决方案** 在单个跳转处添加错误处理: ```javascript this.$router.push('/console').catch(error => { if (error.name !== 'NavigationDuplicated') { // 处理其他类型的导航错误 console.error('导航错误:', error) } }) ``` #### 3. **条件跳转法** 跳转前检查当前路由: ```javascript if (this.$route.path !== '/console') { this.$router.push('/console') } ``` #### 错误原因分析 - 当重复跳转到**完全相同**的路由(包括路径、参数、查询)时触发 - vue-router 3.1.0+ 为导航方法添加了 Promise 返回值[^3][^4] - 设计目的是防止冗余导航,但需要开发者显式处理该异常 #### 最佳实践建议 1. 对于简单项目,使用全局方案一劳永逸 2. 需要精确错误处理时使用局部方案 3. 重要导航操作建议始终添加`.catch()`处理 4. 使用 Vue Devtools 检查路由状态辅助调试 > 示例:当用户连续点击同一个导航按钮时,全局方案会自动忽略重复导航请求,同时保证其他路由错误正常抛出[^1][^3]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值