feat(install): 新增 batchInstall 函数用于批量安装插件

Author: l246804

src/batch-install.ts

@@ -0,0 +1,18 @@
+import type { Router } from 'vue-router'
+import type { RouterPlugin } from './plugin'
+import { withInstall } from './with-install'
+
+/**
+ * Install multiple plugins to a router instance at once.
+ * This is equivalent to calling `plugin.install(router)` for each plugin.
+ * @param router router instance
+ * @param plugins plugins to install
+ *
+ * @example
+ * ```ts
+ * batchInstall(router, [AuthPlugin, CachePlugin])
+ * ```
+ */
+export function batchInstall(router: Router, plugins: RouterPlugin[]): void {
+  plugins.forEach(plugin => withInstall(plugin).install(router))
+}

src/index.ts

@@ -1,3 +1,4 @@
+export * from './batch-install'
 export * from './create-router'
 export * from './deprecated/as-vue-plugin'
 export * from './deprecated/create-vue-router-plugin'

src/override-router-install.ts

@@ -13,7 +13,7 @@ export function overrideRouterInstall(router: Router): void {
     return
   }
 
-  // 避免重复重写
+  // 避免多次重写
   internals.isInstallOverridden = true
 
   // 重写 install 方法

src/with-install.ts

@@ -13,6 +13,12 @@ export interface RouterPluginInstall {
   install: (instance: App | Router) => void
 }
 
+const WITH_INSTALL = '__WITH_INSTALL__'
+
+type RouterPluginInternal = RouterPlugin & {
+  [WITH_INSTALL]?: true
+}
+
 /**
  * Add an `install` method to the plugin to adapt it to Vue's plugin registration mechanism,
  * or to manually install the plugin with an router instance.
@@ -34,7 +40,13 @@ export interface RouterPluginInstall {
 export function withInstall(
   plugin: RouterPlugin,
 ): RouterPlugin & RouterPluginInstall {
+  if ((plugin as RouterPluginInternal)[WITH_INSTALL]) {
+    return plugin as RouterPlugin & RouterPluginInstall
+  }
+
   return Object.assign(plugin, {
+    [WITH_INSTALL]: true,
+
     install(instance: App | Router) {
       if (isRouter(instance)) {
         overrideRouterInstall(instance)