내비게이션 가드
가드로 라우트를 보호하고 내비게이션 중 로직을 실행합니다.
내비게이션 가드은(는) CoddyKit의 무료 Vue Academy 강의입니다. 이것은 3개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vue Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vue Academy 강의에는 총 3개의 강의가 포함되어 있습니다.
탐색 가드란 무엇인가
탐색 가드를 사용하면 route가 변경되기 전, 변경되는 동안 또는 변경된 후에 코드를 실행할 수 있습니다.
- 탐색을 차단하거나 리디렉션합니다
- 인증을 확인합니다
- 페이지를 떠나기 전에 확인합니다
가드의 유형
가드는 세 가지 수준으로 나뉩니다.
- 전역 가드는 모든 탐색에서 실행됩니다
- route별 가드는 하나의 특정 route에서 실행됩니다
- 컴포넌트 내부 가드는 컴포넌트 안에서 실행됩니다
beforeEach 전역 가드
router.beforeEach는 모든 탐색 전에 실행됩니다. 대상 route와 현재 route를 전달받습니다.
router.beforeEach((to, from) => {
console.log("going to", to.path)
// return true to allow,
// or a route to redirect
})허용 또는 리디렉션
Vue 라우터 4에서는 값을 반환해 흐름을 제어합니다.
- 참 또는 아무 값도 반환하지 않으면 허용합니다
- 거짓을 반환하면 취소합니다
- route 위치를 반환하면 리디렉션합니다
router.beforeEach((to) => {
if (to.meta.requiresAuth && !isLoggedIn()) {
return { name: "login" }
}
return true
})route 메타 필드
requiresAuth와 같은 사용자 지정 메타 데이터를 route에 연결하고 가드에서 읽을 수 있습니다.
const routes = [
{
path: "/dashboard",
component: Dashboard,
meta: { requiresAuth: true }
}
]인증 가드
일반적인 방식은 전역 가드에서 인증을 확인하여 route를 보호하는 것입니다.
router.beforeEach((to) => {
const authed = localStorage.getItem("token")
if (to.meta.requiresAuth && !authed) {
return { name: "login", query: { redirect: to.fullPath } }
}
})route별 beforeEnter
beforeEnter는 route 정의 안에서 하나의 route를 직접 보호합니다.
const routes = [
{
path: "/admin",
component: Admin,
beforeEnter: (to, from) => {
return isAdmin() ? true : { name: "home" }
}
}
]컴포넌트 내부 가드
컴포넌트는 자체 가드를 정의할 수 있습니다. onBeforeRouteLeave는 다른 곳으로 탐색할 때 실행됩니다.
import { onBeforeRouteLeave } from "vue-router"
onBeforeRouteLeave((to, from) => {
if (hasUnsavedChanges.value) {
return window.confirm("Leave without saving?")
}
})onBeforeRouteUpdate
onBeforeRouteUpdate는 route가 변경되지만 같은 컴포넌트가 재사용될 때(매개변수 변경) 실행됩니다.
import { onBeforeRouteUpdate } from "vue-router"
onBeforeRouteUpdate((to) => {
loadUser(to.params.id)
})다음 콜백(기존 방식)
이전 코드에서는 세 번째 인수인 다음을 사용해 탐색을 제어합니다. 현재는 값을 반환하는 방식이 권장됩니다.
// Classic style with next()
router.beforeEach((to, from, next) => {
if (canAccess(to)) {
next() // proceed
} else {
next("/login") // redirect
}
})반환값과 다음 호출 비교
목표는 같지만 방식이 두 가지입니다.
- 값 반환(현대적이고 간결함): 참, 거짓 또는 위치를 반환합니다
- 다음 호출(기존 방식): 진행하거나 리디렉션합니다
같은 가드에서 두 방식을 섞지 마세요. 새 코드에는 반환 방식이 권장됩니다.
빠른 확인
탐색 가드에 대해 이해한 내용을 확인해 보세요.
다시 보기: 탐색 가드
탐색을 제어하는 방법을 배웠습니다.
- beforeEach 전역 가드는 모든 route에서 실행됩니다
- 참을 반환하면 허용하고, 거짓을 반환하면 취소하며, 위치를 반환하면 리디렉션합니다
- requiresAuth와 같은 메타 필드로 인증 확인을 수행합니다
- beforeEnter는 하나의 route를 보호합니다
- onBeforeRouteLeave와 같은 컴포넌트 내부 가드는 페이지를 떠나는 작업을 처리합니다
기초 Vue.js 과정을 모두 완료했습니다!
자주 묻는 질문
“내비게이션 가드” 강의는 무료인가요?
네 — “내비게이션 가드” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vue Academy 강의 전체를 잠금 해제할 수 있습니다. Vue Academy 강의에는 총 3개의 강의가 포함되어 있습니다.
“내비게이션 가드”에서 뭘 배우나요?
가드로 라우트를 보호하고 내비게이션 중 로직을 실행합니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Vue Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Vue Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 3개 중 3번째 강의입니다.
“내비게이션 가드” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Vue Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Vue Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- Vue Router 설정
- 중첩 라우트와 동적 라우트
- 내비게이션 가드