Vue Router es el enrutador oficial del lado del cliente para Vue SPAs. Mapea URLs a componentes y los intercambia sin recargar completamente la página y proporciona guardianes de navegación para ejecutar lógica (como verificaciones de autenticación) antes de la navegación.
{ createRouter, createWebHistory } ;
routes = [
{ : , : },
{ : , : },
{ : , : (),
: { : } },
];
router = ({ : (), routes });
<template>
<RouterLink to="/users/42">Profile</RouterLink> <!-- declarative navigation -->
<RouterView /> <!-- where the matched component renders -->
</template>
<script setup>
import { useRoute, useRouter } from "vue-router";
const route = useRoute(); // read current route: route.params.id, route.query
const router = useRouter(); // navigate programmatically: router.push("/home")
</script>
// global guard — runs before EVERY navigation (great for auth)
router.beforeEach((to, from) => {
const authed = useAuthStore().isLoggedIn;
if (to.meta.requiresAuth && !authed) {
return "/login"; // redirect: return a path (or false to cancel)
}
// returning true / nothing → allow the navigation
});
Los guardianes reciben to (ruta de destino) y from (actual) y pueden permitir, cancelar (false) o redirigir (devolver una ubicación). La bandera meta.requiresAuth + un beforeEach global es el patrón canónico de puerta de autenticación.
Global: router.beforeEach / afterEach — every navigation (auth, analytics)
Per-route: beforeEnter in the route config — specific routes
In-component: onBeforeRouteLeave — e.g. "unsaved changes, leave?" prompts
{ path: "/settings", component: Settings, children: [
{ path: "profile", component: Profile }, // → /settings/profile, renders in nested <RouterView>
]}
Además: parámetros de ruta, cadenas de consulta, rutas nombradas, comportamiento de desplazamiento y componentes de ruta cargados de forma diferida para división de código.
Vue Router es esencial para cualquier Vue SPA de varias páginas — proporciona navegación del lado del cliente (rápida, sin recargas), rutas dinámicas/anidadas y RouterLink/RouterView.
Los guardianes de navegación son la característica clave para problemas transversales: puerta de rutas protegidas por autenticación, registro de vistas de página y prevención de navegación fuera de formularios sin guardar.
El patrón meta + beforeEach global para autenticación es algo que implementa casi toda aplicación real.