feat(router): add getRoutes

Author: posva

flow/declarations.js

@@ -65,6 +65,7 @@ declare type RouteConfig = {
 
 declare type RouteRecord = {
   path: string;
+  alias: Array<string>;
   regex: RouteRegExp;
   components: Dictionary<any>;
   instances: Dictionary<any>;

src/create-matcher.js

@@ -13,6 +13,7 @@ export type Matcher = {
   match: (raw: RawLocation, current?: Route, redirectedFrom?: Location) => Route;
   addRoutes: (routes: Array<RouteConfig>) => void;
   addRoute: (parentNameOrRoute: string | RouteConfig, route?: RouteConfig) => void;
+  getRoutes: () => Array<RouteRecord>;
 };
 
 export function createMatcher (
@@ -29,6 +30,22 @@ export function createMatcher (
     const parent = (typeof parentOrRoute !== 'object') ? nameMap[parentOrRoute] : undefined
     // $flow-disable-line
     createRouteMap([route || parentOrRoute], pathList, pathMap, nameMap, parent)
+
+    // add aliases of parent
+    if (parent) {
+      createRouteMap(
+        // $flow-disable-line route is defined if parent is
+        parent.alias.map(alias => ({ path: alias, children: [route] })),
+        pathList,
+        pathMap,
+        nameMap,
+        parent
+      )
+    }
+  }
+
+  function getRoutes () {
+    return pathList.map(path => pathMap[path])
   }
 
   function match (
@@ -175,6 +192,7 @@ export function createMatcher (
   return {
     match,
     addRoute,
+    getRoutes,
     addRoutes
   }
 }

src/create-route-map.js

@@ -93,6 +93,11 @@ function addRouteRecord (
     path: normalizedPath,
     regex: compileRouteRegex(normalizedPath, pathToRegexpOptions),
     components: route.components || { default: route.component },
+    alias: route.alias
+      ? typeof route.alias === 'string'
+        ? [route.alias]
+        : route.alias
+      : [],
     instances: {},
     enteredCbs: {},
     name,

src/index.js

@@ -244,6 +244,10 @@ export default class VueRouter {
     }
   }
 
+  getRoutes () {
+    return this.matcher.getRoutes()
+  }
+
   addRoute (parentOrRoute: string | RouteConfig, route?: RouteConfig) {
     this.matcher.addRoute(parentOrRoute, route)
     if (this.history.current !== START) {

test/unit/specs/create-matcher.spec.js

@@ -54,6 +54,25 @@ describe('Creating Matcher', function () {
     expect(matcher.match('/p/c/n').name).toBe('nested')
   })
 
+  it('can get all routes', function () {
+    const component = { name: 'fake' }
+    const matcher = createMatcher([])
+
+    expect(matcher.getRoutes()).toEqual([])
+
+    matcher.addRoute({ path: '/b', name: 'b', component })
+    expect(matcher.getRoutes().length).toBe(1)
+
+    matcher.addRoute({ path: '/c', name: 'c', alias: ['/a', '/d'], component })
+    expect(matcher.getRoutes().length).toBe(4)
+
+    matcher.addRoute('b', { path: 'd', component })
+    expect(matcher.getRoutes().length).toBe(5)
+
+    matcher.addRoute('c', { path: 'd', component })
+    expect(matcher.getRoutes().length).toBe(8)
+  })
+
   it('in development, has logged a warning if a named route does not exist', function () {
     process.env.NODE_ENV = 'development'
     const { name, matched } = match({ name: 'bar' }, routes[0])