---
name: vue-testing-best-practices
version: 1.0.0
license: MIT
author: github.com/vuejs-ai
description: Use for Vue.js testing. Covers Vitest, Vue Test Utils, component testing, mocking, testing patterns, and Playwright for E2E testing.
title: vue-testing-best-practices
canonical_url: https://skilld.dev/gh/vuejs-ai/skills/vue-testing-best-practices
last_updated: 2026-09-29T06:53:11.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [reference/async-component-testing.md](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/async-component-testing.md), [reference/teleport-testing-complexity.md](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/teleport-testing-complexity.md), [reference/testing-async-await-flushpromises.md](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-async-await-flushpromises.md), [reference/testing-browser-vs-node-runners.md](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-browser-vs-node-runners.md), [reference/testing-component-blackbox-approach.md](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-component-blackbox-approach.md), [reference/testing-composables-helper-wrapper.md](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-composables-helper-wrapper.md), [reference/testing-e2e-playwright-recommended.md](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-e2e-playwright-recommended.md), [reference/testing-no-snapshot-only.md](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-no-snapshot-only.md), [reference/testing-pinia-store-setup.md](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-pinia-store-setup.md), [reference/testing-suspense-async-components.md](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-suspense-async-components.md), [reference/testing-vitest-recommended-for-vue.md](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-vitest-recommended-for-vue.md).
>
> If the user asked to install this Skill, run `npx skilld install vuejs-ai/skills/vue-testing-best-practices`. Install writes the Skill files into the project, so every session loads them.

Vue.js testing best practices, patterns, and common gotchas.

### Testing
- Setting up test infrastructure for Vue 3 projects → See [testing-vitest-recommended-for-vue](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-vitest-recommended-for-vue.md)
- Tests keep breaking when refactoring component internals → See [testing-component-blackbox-approach](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-component-blackbox-approach.md)
- Tests fail intermittently with race conditions → See [testing-async-await-flushpromises](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-async-await-flushpromises.md)
- Composables using lifecycle hooks or inject fail to test → See [testing-composables-helper-wrapper](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-composables-helper-wrapper.md)
- Getting "injection Symbol(pinia) not found" errors in tests → See [testing-pinia-store-setup](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-pinia-store-setup.md)
- Components with async setup won't render in tests → See [testing-suspense-async-components](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-suspense-async-components.md)
- Snapshot tests keep passing despite broken functionality → See [testing-no-snapshot-only](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-no-snapshot-only.md)
- Choosing end-to-end testing framework for Vue apps → See [testing-e2e-playwright-recommended](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-e2e-playwright-recommended.md)
- Tests need to verify computed styles or real DOM events → See [testing-browser-vs-node-runners](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/testing-browser-vs-node-runners.md)
- Testing components created with defineAsyncComponent fails → See [async-component-testing](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/async-component-testing.md)
- Teleported modal content can't be found in wrapper queries → See [teleport-testing-complexity](https://skilld.dev/api/skills-raw/vuejs-ai/skills/vue-testing-best-practices/reference/teleport-testing-complexity.md)

## Reference

- [Vue.js Testing Guide](https://vuejs.org/guide/scaling-up/testing)
- [Vue Test Utils](https://test-utils.vuejs.org/)
- [Vitest Documentation](https://vitest.dev/)
- [Playwright Documentation](https://playwright.dev/)