0Pricing
Vue Academy · 강의

내비게이션 가드

가드로 라우트를 보호하고 내비게이션 중 로직을 실행합니다.

내비게이션 가드은(는) 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 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. Vue Router 설정
  2. 중첩 라우트와 동적 라우트
  3. 내비게이션 가드
← Vue Academy(으)로 돌아가기