К основному содержанию
скилл CX Codex

vue-test-utils-skilld — скилл для Claude Code

Скилл vue-test-utils-skilld помогает писать, отлаживать и проверять тесты Vue 3 с @vue/test-utils 2.5.1.

MIT 168 установок ★ 186 обновлён 2026-10-10

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add skilld-dev/vue-ecosystem-skills --skill vue-test-utils-skilld -a claude-code
Открыть на GitHub

Что делает vue-test-utils-skilld

Скилл подсказывает актуальный API @vue/test-utils 2.5.1 для Vue 3: mount, shallowMount, findComponent, flushPromises, renderToString и обёртки компонентов и DOM. Он помогает выбирать между get() и find(), дожидаться асинхронных методов и настраивать автоматический unmount.

Материалы охватывают параметры монтирования, заглушки, provide, директивы, Teleport, Suspense, composables и миграцию с Vue Test Utils v1. Скилл также объясняет, как тестировать SSR и промисы, которые Vue не отслеживает.

Для работы нужны Vue 3.x, @vue/compiler-dom 3.x и браузероподобное DOM-окружение вроде jsdom или happy-dom. @vue/server-renderer 3.x требуется для renderToString, а для Vue 2 этот скилл не подходит.

Какие задачи решает

  • написать тест компонента Vue 3
  • выбрать между mount и shallowMount
  • найти компонент или DOM-элемент в обёртке
  • дождаться обновления DOM после промиса
  • перенести тесты с Vue Test Utils v1

Примеры запросов агенту

  • Напиши тест для Counter.vue через @vue/test-utils: смонтируй компонент с props и проверь клик по кнопке.
  • Проверь, почему тест Vue-компонента с findComponent выполняет проверку до обновления DOM.
  • Перепиши тест с Vue Test Utils v1 на текущий API @vue/test-utils для Vue 3.

Как установить vue-test-utils-skilld

1Через Skills CLI (Vercel)

npx skills add skilld-dev/vue-ecosystem-skills --skill vue-test-utils-skilld -a claude-code

2Вручную: положить файлы

~/.claude/skills/vue-test-utils-skilld/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/vue-test-utils-skilld/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о vue-test-utils-skilld

Как установить vue-test-utils-skilld в Claude Code?

Выполните npx skills add skilld-dev/vue-ecosystem-skills --skill vue-test-utils-skilld -a claude-code, затем проверьте файл ~/.claude/skills/vue-test-utils-skilld/SKILL.md.

Что делает vue-test-utils-skilld?

Скилл даёт агенту правила и рецепты для тестов Vue 3 с @vue/test-utils 2.5.1: монтирование, запросы к обёрткам, асинхронность, заглушки и миграцию с v1.

Что нужно для работы скилла?

Нужны Vue 3.x, @vue/compiler-dom 3.x и DOM-окружение jsdom или happy-dom. Для renderToString нужен @vue/server-renderer 3.x.

Исходный текст

SKILL.md · MIT
---
name: vue-test-utils-skilld
description: ALWAYS use when writing, debugging, or reviewing code that imports "@vue/test-utils" or mentions vue test-utils, VTU, mount, shallowMount, findComponent, wrapper queries, or migrating from Vue Test Utils v1. Provides the current API surface, mounting options, wrapper methods, and testing recipes for @vue/test-utils 2.5.1 on Vue 3.
license: MIT
---

# @vue/test-utils 2.5.1 (Vue 3)

Prepared source: `input/source`, version 2.5.1 (`package.json:3`).
Requires Vue 3.x and `@vue/compiler-dom` 3.x as peers; `@vue/server-renderer` 3.x is an optional peer needed only for `renderToString` (`package.json:73-81`).
Test-runner agnostic (Vitest, Jest, others). Needs a browser-like DOM environment (jsdom or happy-dom).

Install: `npm install @vue/test-utils --save-dev`

## Quick start

```ts
import { mount } from '@vue/test-utils'
import Counter from './Counter.vue'

test('increments', async () => {
  const wrapper = mount(Counter, { props: { start: 1 } })
  await wrapper.find('button').trigger('click')
  expect(wrapper.text()).toContain('2')
})
```

## Public API surface

Exports from `dist/src/index.d.ts:13`:

| Export | Kind | Use |
|---|---|---|
| `mount` | function | Mount a component, returns `VueWrapper` (`dist/src/mount.d.ts:17`) |
| `shallowMount` | function | Same as `mount` with all child components stubbed (`dist/src/mount.d.ts:22`) |
| `renderToString` | function | SSR-render a component to a string, `Promise<string>` (`dist/src/renderToString.d.ts:4`) |
| `flushPromises` | function | Await pending non-Vue promises (mocked API calls, timers) (`dist/src/utils/flushPromises.d.ts:1`) |
| `enableAutoUnmount(hook)` | function | Unmount all wrappers via a test hook (`dist/src/utils/autoUnmount.d.ts:4`) |
| `disableAutoUnmount` | function | Stop auto unmounting (`dist/src/utils/autoUnmount.d.ts:3`) |
| `VueWrapper` | class | Wrapper around a mounted component instance (`dist/src/vueWrapper.d.ts:5`) |
| `DOMWrapper` | class | Wrapper around a DOM element; `new DOMWrapper(document.body)` (`dist/src/domWrapper.d.ts:4`) |
| `RouterLinkStub` | component | Stub for `<router-link>` (`dist/src/components/RouterLinkStub.d.ts:1`) |
| `config` | object | Shared default mount options and wrapper plugins (`dist/src/config.d.ts:32`) |
| `createWrapperError` | function | Internal; produces the error wrapper returned by `find` misses |

## Core rules

- `await` every method that returns a promise: `trigger`, `setValue`, `setProps`, `setData`, `renderToString`, `flushPromises`. Without `await`, assertions run before the DOM updates.
- Use `get()` / `getComponent()` when the element must exist; they throw on miss. Use `find()` / `findComponent()` only when absence is a valid outcome; they return an error wrapper whose `exists()` is `false`.
- `find()` accepts CSS selectors only. To locate a child component use `findComponent(Component)`, `findComponent({ name: 'Foo' })`, `findComponent({ ref: 'foo' })`, or a CSS selector.
- Register `enableAutoUnmount(afterEach)` once in test setup to prevent state leaks between tests.
- Use `flushPromises()` for promises Vue does not track (mocked HTTP clients, `setTimeout`).
- `wrapper.vm` only reliably exposes what the component exposes: options-API state, `defineExpose()` bindings (since 2.5.0, PR #2927), or `setup()` return values.

```ts
import { enableAutoUnmount } from '@vue/test-utils'
import { afterEach } from 'vitest'

enableAutoUnmount(afterEach)
```

## Version notes: 2.4.10 -> 2.5.1

- BREAKING (2.5.0): class component support removed. Mount Vue components defined with `defineComponent`, options objects, or `<script setup>` SFCs. https://github.com/vuejs/test-utils/releases/tag/v2.5.0
- Fix (2.5.0): `emitted()` history of child components is cleared when they unmount. Assert events before unmounting. https://github.com/vuejs/test-utils/pull/2898
- Fix (2.5.0): `defineExpose` bindings are visible on `findComponent(...).vm`. https://github.com/vuejs/test-utils/pull/2927
- Fix (2.4.11): `setData()` works correctly for components mixing `setup()` and `data()`. https://github.com/vuejs/test-utils/releases/tag/v2.4.11
- Fix (2.4.11): `trigger('keydown')` sets a spec-compliant `event.code`. https://github.com/vuejs/test-utils/pull/2850
- Type (2.4.11): `GlobalMountOptions` is exported. https://github.com/vuejs/test-utils/pull/2851

## Earlier v2 milestones still relevant

- `renderToString` added in 2.3.0 for SSR testing. https://github.com/vuejs/test-utils/releases/tag/v2.3.0
- `html({ raw: true })`, directive stubs (`vName: true`), and array `setValue` for multiselect added in 2.2.0. https://github.com/vuejs/test-utils/releases/tag/v2.2.0
- `enableAutoUnmount` / `disableAutoUnmount` replaced v1 `enableAutoDestroy`. https://github.com/vuejs/test-utils/releases/tag/v2.0.0-rc.16
- `propsData` still works but is deprecated; use `props` (`dist/src/types.d.ts:33-35`).
- `stubs` accepts a record (`{ Foo: true }`) or an array of names (`['Foo']`) (`dist/src/types.d.ts:80`).

## Migrating from v1 (Vue 2)

Full table: [migration reference](./references/migration-v2.md), official guide https://test-utils.vuejs.org/migration/

- `propsData` -> `props`; `createLocalVue` removed -> `global.plugins` / `global.mixins`
- `mocks`, `stubs`, `provide`, `directives` moved under `global`
- `destroy()` -> `unmount()`; `findAll().at(i)` -> `findAll()[i]` (returns an array)
- `createWrapper()` removed -> `new DOMWrapper(el)`
- `setChecked` / `setSelected` removed -> merged into `setValue`
- `find()` no longer finds components by name; use `findComponent`
- `shallowMount` no longer renders default slot content of stubs; restore with `config.global.renderStubDefaultSlot = true`
- Removed: `is`, `isEmpty`, `isVueInstance`, `name`, `setMethods`, `contains`, `scopedSlots` (merged into `slots`)

## Best practices

- Prefer `mount` with targeted `global.stubs` over `shallowMount`. Shallow tests assert structure, not behavior, and stubbed children hide real interactions. https://test-utils.vuejs.org/guide/advanced/stubs-shallow-mount
- If you do stub broadly, set `config.global.renderStubDefaultSlot = true` so default slot content of stubs still renders (`dist/src/types.d.ts:125-131`).
- Stub directives with the `vName` key: `global.stubs: { vTooltip: true }` or pass a replacement directive object.
- `<transition>` and `<transition-group>` are stubbed by default (`dist/src/types.d.ts:120-124`); custom transition stubs are supported.
- Pass inject values through `global.provide`, matching production injection. For typed injection keys, wrap the key: `provide: { [injectionKey as symbol]: value }`.
- Test composables by mounting a minimal host component and reading state from `wrapper.vm`.
- Wrap components with `async setup()` in a `<Suspense>` host before mounting.
- For `<Teleport>`, either stub it (`global.stubs: { teleport: true }`) or create the target element in `beforeEach` and query it with `document.querySelector`. https://test-utils.vuejs.org/guide/advanced/teleport
- Use `RouterLinkStub` when testing around `<router-link>` without installing a router: `global.stubs: { 'router-link': RouterLinkStub }`.

## References

- [Mounting options and config](./references/mounting-options.md): every `mount` / `shallowMount` / `renderToString` option, `global.*`, and the `config` object.
- [Wrapper API](./references/wrapper-api.md): every `VueWrapper` / `DOMWrapper` method with signatures.
- [Migration v1 -> v2](./references/migration-v2.md): full option and method mapping plus 2.5.x changes.
- [Testing recipes](./references/recipes.md): forms, `v-model`, emitted events, router, Vuex/Pinia, Suspense, Teleport, SSR.

© skilld-dev · MIT · skilld-dev/vue-ecosystem-skills

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
vue-testing-best-practices github.com/vuejs-ai Скилл vue-testing-best-practices с правилами и паттернами тестирования приложений на Vue 3. Помогает настроить Vitest и писать тесты компонентов без ошибок внедрения зависимостей. CX Codex +1 15 300установок unit-test-vue-pinia официальный github Скилл unit-test-vue-pinia для GitHub Copilot — помогает писать и проверять юнит-тесты для Vue 3, TypeScript, Vitest и Pinia. Держит тесты на публичных входах, не проваливаясь во внутренности компонентов. CX Codex +1 1 800установок Expert Vue.js Frontend Engineer официальный github Субагент Expert Vue.js Frontend Engineer для GitHub Copilot, который пишет и правит фронтенд на Vue 3 с TypeScript. Берёт на себя компоненты, сторы Pinia, тесты и вопросы производительности в одном рабочем цикле. CX Codex +1 ★ 41 430звёзд репо vue-3-nuxt-3-development-cursorrules-prompt-file PatrickJS Правило vue-3-nuxt-3-development-cursorrules-prompt-file задаёт стандарты для фронтенда на Vue 3 и Nuxt 3 в Cursor. Ассистент составляет псевдокод до написания кода, использует Composition API и оформляет разметку только через Tailwind. CX Codex +1 ★ 41 178звёзд репо antdv-next Antdv Next team Помогает находить документацию компонентов Antdv Next для Vue 3, их props, events и slots. Срабатывает при поиске примеров, API компонентов и определений токенов темы. CX Codex +1 1 500установок vue-expert https://github.com/Jeffallan Скилл vue-expert для Claude Code пишет код на Vue 3 с Composition API, настраивает Nuxt 3, Pinia и Vite. Создаёт компоненты, PWA и гибридные приложения. CX Codex +1 4 800установок

Из того же набора32

Весь набор →
vueuse-core-skilld Скилл vueuse-core-skilld с полным API @vueuse/core 15.0.0: новые composables, правила миграции с v14, устаревшие функции и требования окружения. CX Codex +1 219установок vee-validate-skilld Скилл vee-validate-skilld помогает писать, проверять и отлаживать формы Vue 3 с vee-validate 4.15.x. Даёт актуальные примеры Composition API, паттерны схем валидации, интеграцию typed-schema и решение типичных ошибок. CX Codex +1 188установок primevue-skilld Скилл primevue-skilld помогает писать и обновлять код для PrimeVue v5: настраивать библиотеку, заменять устаревшие API и собирать компоненты из частей. Пригодится в проекте на Vue 3. CX Codex +1 187установок shadcn-vue-skilld Скилл shadcn-vue-skilld для Claude Code, Codex, Cursor и других агентов, покрывающий CLI shadcn-vue 2.8.2 для Vue и Nuxt. Знает точные флаги всех команд — от init до mcp, конфигурацию components.json и правила разрешения имён компонентов. CX Codex +1 174установок vueuse-components-skilld Скилл vueuse-components-skilld помогает писать и отлаживать Vue 3-шаблоны с компонентами и директивами @vueuse/components. Пригодится и при переходе от composable к компонентной или директивной форме. CX Codex +1 168установок motion-v-skilld Скилл motion-v-skilld для анимаций через motion-v (Motion для Vue) — компонент motion, жесты, варианты, директива v-motion, Nuxt-модуль. CX Codex +1 146установок reka-ui-skilld Скилл reka-ui-skilld для Claude Code помогает собирать доступные интерфейсы на Reka UI 2.10.5 во Vue 3, писать чистую композицию и не путать пропсы. CX Codex +1 146установок vueuse-integrations-skilld Скилл vueuse-integrations-skilld учит ИИ-агента правильно использовать 12 обёрток библиотеки @vueuse/integrations v15. Помогает писать типизированный код без ошибок в импортах и сигнатурах. CX Codex +1 145установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой