守衛的種類:
- 全局前置守衛
- 全局后置守衛
- 全局解析守衛
- 路由獨享守衛
- 組件內的守衛
全局前置守衛
定義:每次路由的跳轉都要經過全局守衛,一般是用的都是前置守衛router.beforeEach((to, from, next)=>{})
。
接收三個參數:
- to: 即將要進入的目標;
- from: 當前導航正要離開的路由;
- next: 一定要調用該方法來 resolve 這個鈎子。執行效果依賴
next
方法的調用參數 next()
: 進行管道中的下一個鈎子。如果全部鈎子執行完了,則導航的狀態就是 confirmed (確認的)。next(false)
: 中斷當前的導航。如果瀏覽器的 URL 改變了 (可能是用戶手動或者瀏覽器后退按鈕),那么 URL 地址會重置到from
路由對應的地址。next('/')
或者next({ path: '/' })
: 跳轉到一個不同的地址。當前的導航被中斷,然后進行一個新的導航。你可以向next
傳遞任意位置對象,且允許設置諸如replace: true
、name: 'home'
之類的選項以及任何用在router-link
的to
prop 或router.push
中的選項。next(error)
: (2.4.0+) 如果傳入next
的參數是一個Error
實例,則導航會被終止且該錯誤會被傳遞給router.onError()
注冊過的回調。
注:確保要調用 next
方法,否則鈎子就不會被 resolved。
全局后置守衛
全局后置守衛和守衛不同的是,這些鈎子不會接受 next
函數也不會改變導航本身:
router.afterEach((to, from) => { // ... })
全局解析守衛
在 2.5.0+ 你可以用 router.beforeResolve
注冊一個全局守衛。這和 router.beforeEach
類似,區別是在導航被確認之前,同時在所有組件內守衛和異步路由組件被解析之后,解析守衛就被調用。
路由獨享守衛
你可以在路由配置上直接定義 beforeEnter
守衛:
const router = new VueRouter({ routes: [ { path: '/foo', component: Foo, beforeEnter: (to, from, next) => { // ... } } ] })
組件內的守衛
- beforeRouteEnter
- beforeRouteUpdata
- beforeRouteLeave
const Foo = { template: `...`, beforeRouteEnter (to, from, next) { // 在渲染該組件的對應路由被 confirm 前調用 // 不!能!獲取組件實例 `this` // 因為當守衛執行前,組件實例還沒被創建 next(vm => { // 通過 `vm` 訪問組件實例 }) }, beforeRouteUpdate (to, from, next) { // 在當前路由改變,但是該組件被復用時調用 // 舉例來說,對於一個帶有動態參數的路徑 /foo/:id,在 /foo/1 和 /foo/2 之間跳轉的時候, // 由於會渲染同樣的 Foo 組件,因此組件實例會被復用。而這個鈎子就會在這個情況下被調用。 // 可以訪問組件實例 `this` }, beforeRouteLeave (to, from, next) { // 導航離開該組件的對應路由時調用 // 可以訪問組件實例 `this` } }