A vue-router-style routing management system for uni-app x
Four navigation modes — push / replace / relaunch / back; meta.isTab automatically uses switchTab; useLink / RouterLink for declarative navigation; concurrent navigations are queued and executed serially, duplicate navigations are rejected (DUPLICATED)
Global beforeEach / beforeResolve / afterEach + route-local beforeEnter + in-component guards; return-value-style redirects (depth limit 10); guardTimeout timeout protection; guardRoute re-runs the guard chain on cold start
query goes straight into the URL; params travel across pages via ParamsPlugin (the __params__ internal key channel) with optional persistence; queryInt / queryNumber / queryBool for typed reads
EventsPlugin fills in the events capability missing from uni-app x — pass a listener map in push, the opened page uses useOpenerEventChannel to emit back / receive, plus a global eventBus
AnimationPlugin passes through native animationType / animationDuration on App (officially App-only), implements H5 with the Web Animations API, and back automatically maps to exit-style animations
install registers a global mixin on H5 (onShow auto-syncs via syncRoute); on native platforms pages are advised to call it themselves in onShow; onRouteChange listens for route changes, keeping the page stack and non-router navigations always aligned
RouterError / NavigationFailure with 7 error codes; navigation failures always reject; onError for global capture + isNavigationFailure for precise checks
4 built-in plugins (Params / Events / Animation / Interceptor) instantiated and registered on demand; PluginContext provides 8 hooks for custom extensions; using params without the plugin rejects with PLUGIN_REQUIRED and clear guidance
Strict typing (generic Maps, no implicit conversions); the full composition API set — useRouter / useRoute / useLink / useOpenerEventChannel
Introduction → Getting Started → Route Configuration → Navigation → Route Guards → Recipes
