前言
【vue-router源码】系列文章将带你从0开始理解vue-router
的具体实现。该系列文章源码参考vue-router v4.0.15
。
源码地址:https://github.com/vuejs/router
浏览该文章的前提是你最好理解vue-router
的根本应用,如果你没有应用过的话,可通过vue-router官网学习下。
该篇文章将剖析全局导航守卫的实现。
应用
全局导航守卫有三种:
beforeEach
:在任何导航之前执行。返回一个删除已注册导航守卫的函数。beforeResolve
:在导航解析之前执行。返回一个删除已注册导航守卫的函数。afterEach
:在任何导航之后执行。返回一个删除已注册导航守卫的函数。
const router = createRouter({ // ... })router.beforeEach = function() { // ... }router.beforeResolve = function() { // ... }router.afterEach = function() { // ... }
全局导航守卫实现
全局导航守卫和onError
的实现都是通过保护一个数组进行实现。在vue-router
中通过一个useCallbacks
的函数能够创立一个能够重置的列表,全局钩子及onError
就是通过useCallbacks
实现。
const beforeGuards = useCallbacks<NavigationGuardWithThis<undefined>>()const beforeResolveGuards = useCallbacks<NavigationGuardWithThis<undefined>>()const afterGuards = useCallbacks<NavigationHookAfter>()let errorHandlers = useCallbacks<_ErrorHandler>()const router = { // ... beforeEach: beforeGuards.add, beforeResolve: beforeResolveGuards.add, afterEach: afterGuards.add, onError: errorHandlers.add, // ...}
useCallbacks
:
export function useCallbacks<T>() { let handlers: T[] = [] function add(handler: T): () => void { handlers.push(handler) return () => { const i = handlers.indexOf(handler) if (i > -1) handlers.splice(i, 1) } } function reset() { handlers = [] } return { add, list: () => handlers, reset, }}
useCallbacks
返回一个对象,该对象有三个属性。其中list
是外部保护的列表;add
是一个增加handler
的函数,它返回一个删除对应handler
的函数;reset
是个重置列表的函数。
对于全局导航守卫的执行机会可参考:router.push