Vue Academy · 강의

사용자 상호작용과 이벤트 테스트

wrapper.trigger('click'), setValue(), wrapper.vm.$emit()과 비동기 flushPromises()를 사용합니다.

사용자 상호작용과 이벤트 테스트은(는) CoddyKit의 무료 Vue Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vue Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

사용자 동작 시뮬레이션하기

렌더링을 확인하는 것만으로는 부족합니다. 테스트는 버튼 클릭, 입력 필드에 입력, 양식 제출처럼 사용자가 하는 동작을 모방해야 합니다. @vue/test-utils의 래퍼는 DOM 이벤트를 발생시키고 이후 Vue를 업데이트하는 메서드를 제공합니다.

클릭 이벤트에 trigger 사용하기

wrapper.trigger("click")은 요소에서 클릭을 발생시킵니다. DOM이 업데이트되므로 프로미스를 반환합니다. 검증에서 결과를 확인할 수 있도록 이를 await하세요.

const button = wrapper.get("button")
await button.trigger("click")
expect(wrapper.text()).toContain("Clicked once")

테스트가 비동기인 이유

Vue는 DOM을 비동기적으로 업데이트합니다. 상호작용 직후에는 다음 업데이트 주기가 지나야 새로운 상태가 표시됩니다. trigger 프로미스를 기다리면 검증하기 전에 DOM 업데이트가 완료됩니다.

it("increments on click", async () => {
  const wrapper = mount(Counter)
  await wrapper.get("button").trigger("click")
  expect(wrapper.get(".count").text()).toBe("1")
})

입력에 setValue 사용하기

필드에 입력하려면 입력 래퍼에서 wrapper.setValue(value)를 사용하세요. 이 메서드는 값을 설정하고 input 이벤트를 발생시켜 v-model을 업데이트합니다.

const input = wrapper.get("input")
await input.setValue("hello@example.com")
expect(input.element.value).toBe("hello@example.com")

확인란과 선택 상자

setValue는 요소에 맞게 동작합니다. 확인란에는 불리언 값을, 선택 상자에는 옵션 값을 전달하세요.

await wrapper.get("input[type=checkbox]").setValue(true)
await wrapper.get("select").setValue("tr")

emitted events 검증하기

컴포넌트는 emitted events를 통해 상위 컴포넌트와 통신합니다. wrapper.emitted()는 컴포넌트가 발생시킨 모든 이벤트를 이름별로 기록하여 반환합니다.

await wrapper.get("button").trigger("click")
expect(wrapper.emitted()).toHaveProperty("submit")

emitted payload 검사하기

wrapper.emitted("name")은 발생한 이벤트의 인수 배열을 모은 배열을 반환합니다. 첫 번째 발생의 첫 번째 인수는 emitted("name")[0][0]입니다.

await wrapper.get("button").trigger("click")
const events = wrapper.emitted("submit")
expect(events).toHaveLength(1)
expect(events[0][0]).toEqual({ email: "a@b.com" })

양식 제출 테스트

각 요소를 결합해 보세요. 필드를 채우고, 양식을 제출한 다음, emitted payload를 검증합니다.

it("emits submit with the email", async () => {
  const wrapper = mount(LoginForm)
  await wrapper.get("input").setValue("a@b.com")
  await wrapper.get("form").trigger("submit.prevent")
  expect(wrapper.emitted("submit")[0][0]).toEqual({ email: "a@b.com" })
})

컴포넌트의 비동기 작업

많은 핸들러는 API를 호출하고 프로미스가 이행되면 상태를 업데이트합니다. 검증이 실행될 때까지 마이크로태스크가 실행되지 않았을 수 있으므로 기다려야 합니다.

async function load() {
  loading.value = true
  data.value = await fetchData()
  loading.value = false
}

flushPromises

Test Utils의 flushPromises는 보류 중인 모든 마이크로태스크(then 콜백)를 완료합니다. 비동기 동작을 발생시킨 후 이를 await하면 이행된 프로미스와 그에 따른 DOM 업데이트가 적용됩니다.

import { flushPromises } from "@vue/test-utils"

await wrapper.get("button").trigger("click")
await flushPromises()
expect(wrapper.text()).toContain("Loaded")

비동기 테스트 함께 구성하기

패턴은 다음과 같습니다. 마운트하고, 상호작용하고, await flushPromises()를 실행한 다음 검증합니다. 테스트 함수 전체에서 await를 사용할 수 있도록 함수에 async를 표시하세요.

it("shows results after fetch", async () => {
  const wrapper = mount(SearchBox)
  await wrapper.get("input").setValue("vue")
  await wrapper.get("form").trigger("submit.prevent")
  await flushPromises()
  expect(wrapper.findAll("li")).toHaveLength(2)
})

빠른 확인

상호작용 테스트를 어떻게 작성하는지 이해했는지 확인해 보세요.

복습

상호작용과 이벤트를 테스트하는 방법을 배웠습니다.

trigger("click")은 이벤트를 발생시킵니다. Vue가 비동기적으로 업데이트하므로 반드시 기다리세요.
setValue는 입력 필드, 확인란, 선택 상자의 값을 설정하고 v-model을 위한 input 이벤트를 발생시킵니다.
wrapper.emitted()는 발생한 이벤트를 기록하고, emitted("name")[0][0]은 첫 번째 payload를 읽습니다.
비동기 핸들러를 검증하기 전에는 await flushPromises()를 사용하세요.
await를 사용하려면 테스트에 async를 표시하세요.

자주 묻는 질문

“사용자 상호작용과 이벤트 테스트” 강의는 무료인가요?

네 — “사용자 상호작용과 이벤트 테스트” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vue Academy 강의 전체를 잠금 해제할 수 있습니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“사용자 상호작용과 이벤트 테스트”에서 뭘 배우나요?

wrapper.trigger('click'), setValue(), wrapper.vm.$emit()과 비동기 flushPromises()를 사용합니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Vue Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Vue Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“사용자 상호작용과 이벤트 테스트” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Vue Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Vue Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Vue Academy(으)로 돌아가기