🛡 Vue Router Shield

Looking for a clean and elegent way to define navigation guards in your Vue.js application ? This library is made for you ! Whether you want to authenticate your users across your application, or just fetch some data before entering a view, this is a perfect fit.

How does it differ from built in navigation guards ?

| Feature | Vue Router | Vue Router Shield | |---------------------------|------------|-------------------| | Route based before enter | ✅ | ✅ | | Route based before update | ❌ | ✅ | | Route based before each | ❌ | ✅ |

Installation 🔽

Note : compatible with Vue.js V2 and V3 !

npm install vue-router-shield
# or
yarn add vue-router-shield

import VueRouterShield from 'vue-router-shield'

Vue.use(VueRouterShield, {
  router // A router instance must be given
})

Usage 🔽

Guards are defined at the route level, and can be executed before entering the route, before the route is updated, or both : you decide. Let's create a guard that will be called BeforeEach navigations and log a greeting message :

import { BeforeEach } from 'vue-router-shield'

export default BeforeEach((to, from, next) => {
  console.log('Hello !')
  
  next()
})

Now, this guard must be bound to the route on which we want it to be executed. Of course, we can list as many as we want, and they'll all be called one after the other :

{
  routes: [
    {
      path: '/',
      component: {},
      meta: { guard: [SayHello] }
    }
  ]
}

As said above, the guards can be executed in three different ways :

// BeforeEach guards are executed when the route they're bound to is entered or updated
import { BeforeEach } from 'vue-router-shield'

export default BeforeEach((to, from, next) => {
  next()
})

// BeforeUpdate guards are executed only when the route they're bound to is updated
import { BeforeUpdate } from 'vue-router-shield'

export default BeforeUpdate((to, from, next) => {
  next()
})

// BeforeEnter guards are executed only when the route they're bound to is entered
import { BeforeEnter } from 'vue-router-shield'

export default BeforeEnter((to, from, next) => {
  next()
})

They are called with three arguments : the route we're going to, the route we're coming from, and a next function that must be called in order to validate the navigation. If you want to abort the navigation or create a redirect, either pass false or a route location.

Configuration 🔽

Instead of guard as the name of the meta field the guards are taken from, you can choose another one when initializing the library :

import VueRouterShield from 'vue-router-shield'

Vue.use(VueRouterShield, {
  router,
  guard: 'middleware'
})