关于javascript:Vue-代码-AST-转换升级实战-vuerouter-篇

前言

最近咱们公布了《阿里妈妈又做了新工具，帮你把 Vue2 代码改成 Vue3 的》这个 Vue2 降级工具，上面跟大家分享下咱们如何利用 GoGoCode 对 VueRouter 进行代码降级的。

Vue Router 是什么

贴一个官网介绍：
Vue Router 是 Vue.js 官网的路由管理器。它和 Vue.js 的外围深度集成，让构建单页面利用变得大海捞针

作为 Vue 开发的标配之一，Vue Router 追随 Vue3 同步降级，API 定义与应用上有了一些破坏性的变动。为了实现一键 Vue2 降级 Vue3，咱们把 Vue Router 的转换规则进行了拆解与钻研，上面举几个应用 GoGoCode 的转换场景跟大家分享下：

利用 GoGoCode 降级 Vue Router

GoGoCode 的应用能够 参考这里

1. new Router 变成 createRouter

1.1 API 的变动

Vue Router 不再是一个类，而是一组函数。当初你不必再写 new Router()，而是要调用
createRouter:

// 以前是
// import Router from 'vue-router'
import {createRouter} from 'vue-router'

const router = createRouter({// ...})

1.2 应用 GoGoCode 转换

解决下面 API 的变动，咱们只须要利用 GoGoCode 的 replace 办法，两行代码搞定

// import 形式转换
ast.replace(`import $_$ from 'vue-router'`, 
            `import * as VueRouter from 'vue-router'`);

// 创立 Router 实例办法转换
ast.replace(`new Router($_$)`, `VueRouter.createRouter($_$)`);

我也来试试：地址

2. 新的 history 配置取代 mode

2.1 API 的变动

mode: 'history' 配置曾经被一个更灵便的 history 配置所取代。依据你应用的模式，你必须用适当的函数替换它：

• "history": createWebHistory()
• "hash": createWebHashHistory()

• "abstract": createMemoryHistory()

  import {createRouter, createWebHistory} from 'vue-router'
  // 还有 createWebHashHistory 和 createMemoryHistory
  
  createRouter({history: createWebHistory(),
  routes: [],})

  2.2 应用 GoGoCode 转换

  VueRouter 中的 mode 配置，能够通过 GoGoCode 的 replace 办法，替换成 history 配置，如果没有 mode 配置，则应用默认配置：history:createWebHashHistory

  
  if (ast.has(`{mode:$_$}`)) {
  // router 定义中存在 mode 属性，replace 替换
    ast.replace(`mode:'history'`, 
              `history: VueRouter.createWebHistory()`);
    ast.replace(`mode:'hash'`, 
              `history: VueRouter.createWebHashHistory()`);
    ast.replace(`mode:'abstract'`, 
              `history: VueRouter.createMemoryHistory()`);
  } else {
  // router 定义中不存在 mode 属性，默认采纳 createWebHashHistory
    ast.replace(`{routes:$_$,$$$}`, 
              `{history: VueRouter.createWebHashHistory(),routes:$_$,$$$}`);
  }

  我也来试试：地址

  3. 挪动了 base 配置

  3.1 API 的变动

  base​配置被作为 createWebHistory (其余 history 也一样)的第一个参数传递：

  import {createRouter, createWebHistory} from 'vue-router'
  createRouter({history: createWebHistory('/base-directory/'),
  routes: [],})

  3.2 应用 GoGoCode 转换

  通过 GoGoCode 通配符号：$_$和 $$$, 将base 及其它代码进行乾坤大挪移，能够霎时实现代码片段转移。

  ast.replace(`{$$$,history: VueRouter.createWebHistory(), base: $_$}`,
    `{$$$,history: VueRouter.createWebHistory($_$)}`)

  我也来试试：地址

  4. \<router-view>、\<keep-alive> 和 \<transition>

  4.1 API 的变动

  transition 和 keep-alive 当初必须通过 v-slot API 在 RouterView 外部 应用：

  <router-view v-slot="{Component}">
  <transition>
    <keep-alive>
      <component :is="Component" />
    </keep-alive>
  </transition>
  </router-view>

  4.2 应用 GoGoCode 转换

  GoGoCode 同样能解决 html 代码，咱们将 router-view 节点转移到 transition 外层，同时放弃原来的属性及外部元素构造不变，应用replace 可霎时实现。

  ast.replace(`<transition $$$1><router-view $$$2>$$$3</router-view></transition>`,
  `<router-view v-slot="{Component}" $$$2>
    <transition $$$1>
        <component :is="Component" >$$$3</component>
    </transition>
  </router-view>`);

  我也来试试：地址

  最初

  这里只是列举了四个比拟典型的 VueRouter 应用场景上的变动，蕴含了 js 和 html 代码转换。其余转换规则能够看下咱们的 GitHub。这些转换规则都是应用了 GoGoCode 之后极大地简化了操作 AST 对象老本，基本上一个 replace 办法就能搞定，遇到代码转换需要十分举荐大家应用 GoGoCode！
  ​

如果在应用 GoGoCode 过程中遇到问题能够分割咱们：
github: https://github.com/thx/gogocode/issues
钉钉群：34266233

感谢您的浏览，祝您有美妙的一天！