vue-testing-best-practices · rockcookies - Agent Skill

01 前言 Front Matter

name: vue-testing-best-practices
author: github.com/vuejs-ai
license: MIT
version: 1.0.0
description: Use for Vue.js testing. Covers Vitest, Vue Test Utils, component testing, mocking, testing patterns, and Playwright for E2E testing.

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

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

层级 AGENTS.md / README.md：init、update、audit、reorganize、trim。初始化 Agent 指令、代码改动后同步文档、检查文档漂移、重组仓库文档层级、精简规则与 Skills。 Not for 写业务代码或生成文档站点。

Apply VueUse composables where appropriate to build concise, maintainable Vue.js / Nuxt features.

Vue Router 4 patterns, navigation guards, route params, and route-component lifecycle interactions.

Pinia stores, state management patterns, store setup, and reactivity with stores.

Vue 3 Options API style (data(), methods, this context). Each reference shows Options API solution only.

JSX syntax in Vue (e.g., class vs className, JSX plugin config).