---

name: vue-testing description: Master Vue Testing - Vitest, Vue Test Utils, Component Testing, E2E with Playwright sasmp_version: "1.3.0" bonded_agent: 06-vue-testing bond_type: PRIMARY_BOND version: "2.0.0" last_updated: "2025-01"

Vue Testing Skill

Production-grade skill for mastering Vue application testing with Vitest, Vue Test Utils, and Playwright.

Purpose

Single Responsibility: Teach comprehensive testing strategies for Vue applications including unit, component, integration, and E2E testing.

Parameter Schema

Copyinterface VueTestingParams {
  topic: 'unit' | 'component' | 'integration' | 'e2e' | 'mocking' | 'all';
  level: 'beginner' | 'intermediate' | 'advanced';
  context?: {
    test_runner?: 'vitest' | 'jest';
    e2e_tool?: 'playwright' | 'cypress';
    coverage_target?: number;
  };
}

Learning Modules

Module 1: Testing Fundamentals

CopyPrerequisites: vue-fundamentals
Duration: 2 hours
Outcome: Set up testing environment

Vitest Configuration:

Copy// vitest.config.ts
export default defineConfig({
  plugins: [vue()],
  test: {
    globals: true,
    environment: 'jsdom',
    coverage: {
      provider: 'v8',
      thresholds: { lines: 80 }
    }
  }
})

Module 2: Component Testing

CopyPrerequisites: Module 1
Duration: 4-5 hours
Outcome: Test Vue components thoroughly

Component Test Template:

Copyimport { mount } from '@vue/test-utils'
import MyComponent from './MyComponent.vue'

describe('MyComponent', () => {
  it('renders correctly', () => {
    const wrapper = mount(MyComponent, {
      props: { title: 'Test' }
    })
    expect(wrapper.text()).toContain('Test')
  })

  it('emits event on click', async () => {
    const wrapper = mount(MyComponent)
    await wrapper.find('button').trigger('click')
    expect(wrapper.emitted('action')).toHaveLength(1)
  })
})

Module 3: Mocking Strategies

CopyPrerequisites: Module 2
Duration: 3 hours
Outcome: Mock dependencies effectively

Module 4: Testing Composables & Stores

CopyPrerequisites: Module 3
Duration: 3 hours
Outcome: Test reusable logic

Composable Testing:

Copyimport { useCounter } from './useCounter'

it('increments count', () => {
  const { count, increment } = useCounter()
  increment()
  expect(count.value).toBe(1)
})

Store Testing:

Copyimport { setActivePinia, createPinia } from 'pinia'
import { useUserStore } from './useUserStore'

beforeEach(() => setActivePinia(createPinia()))

it('logs in user', async () => {
  const store = useUserStore()
  await store.login(credentials)
  expect(store.isLoggedIn).toBe(true)
})

Module 5: E2E Testing with Playwright

CopyPrerequisites: Modules 1-4
Duration: 4 hours
Outcome: Write reliable E2E tests

Playwright Test:

Copyimport { test, expect } from '@playwright/test'

test.describe('Login', () => {
  test('logs in successfully', async ({ page }) => {
    await page.goto('/login')
    await page.getByLabel('Email').fill('user@example.com')
    await page.getByLabel('Password').fill('password')
    await page.getByRole('button', { name: 'Submit' }).click()

    await expect(page).toHaveURL('/dashboard')
    await expect(page.getByText('Welcome')).toBeVisible()
  })
})

Validation Checkpoints

Beginner Checkpoint

• Set up Vitest with Vue
• Write basic component test
• Test props and events
• Run tests with coverage

Intermediate Checkpoint

• Mock API calls
• Test async components
• Test composables
• Test Pinia stores

Advanced Checkpoint

• Write E2E tests with Playwright
• Achieve 80%+ coverage
• Test edge cases
• Set up CI testing

Retry Logic

Copyconst skillConfig = {
  maxAttempts: 3,
  backoffMs: [1000, 2000, 4000],
  onFailure: 'provide_test_hint'
}

Observability

Copytracking:
  - event: test_written
    data: [test_type, component_name]
  - event: coverage_achieved
    data: [percentage, file_count]
  - event: skill_completed
    data: [tests_written, coverage]

Troubleshooting

Common Issues

Debug Steps

1. Check test isolation (beforeEach cleanup)
2. Verify mock is at file top
3. Console.log wrapper.html()
4. Use Playwright trace viewer

Unit Test Template

Copyimport { describe, it, expect, beforeEach, vi } from 'vitest'
import { mount, VueWrapper } from '@vue/test-utils'
import Component from './Component.vue'

describe('Component', () => {
  let wrapper: VueWrapper

  beforeEach(() => {
    wrapper = mount(Component, {
      props: {},
      global: {
        stubs: {},
        mocks: {},
        plugins: []
      }
    })
  })

  it('renders correctly', () => {
    expect(wrapper.exists()).toBe(true)
  })

  it('handles user interaction', async () => {
    await wrapper.find('button').trigger('click')
    expect(wrapper.emitted('action')).toBeTruthy()
  })
})

Usage

CopySkill("vue-testing")

Related Skills

• vue-fundamentals - Prerequisite
• vue-composition-api - For composable testing
• vue-pinia - For store testing

Resources

• Vitest Documentation
• Vue Test Utils
• Playwright
• Testing Library