Vue Test Utils 2.4.6 官方测试工具：Vue.js 组件单元测试与集成测试指南

vue-test-utils-skilld by harlan-zw/vue-ecosystem-skills

68 周安装量

147 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/harlan-zw/vue-ecosystem-skills --skill vue-test-utils-skilld

Vue JavaScript 框架测试

🇨🇳中文介绍

vuejs/test-utils `@vue/test-utils`

版本: 2.4.6 依赖: js-beautify@^1.14.9, vue-component-type-helpers@^2.0.0 标签: latest: 2.4.6, 2.0.0-alpha.0: 2.0.0-alpha.0, 2.0.0-alpha.1: 2.0.0-alpha.1, 2.0.0-alpha.2: 2.0.0-alpha.2, 2.0.0-alpha.3: 2.0.0-alpha.3, 2.0.0-alpha.4: 2.0.0-alpha.4, next: 2.4.0-alpha.2, 2.0.0-alpha.8: 2.0.0-alpha.8, 2.0.0-beta.1: 2.0.0-beta.1, 2.0.0-beta.2: 2.0.0-beta.2, 2.0.0-beta.3: 2.0.0-beta.3, 2.0.0-beta.4: 2.0.0-beta.4, 2.0.0-beta.5: 2.0.0-beta.5, 2.0.0-beta.7: 2.0.0-beta.7, 2.0.0-beta.8: 2.0.0-beta.8, 2.0.0-beta.9: 2.0.0-beta.9, 2.0.0-beta.10: 2.0.0-beta.10, 2.0.0-beta.12: 2.0.0-beta.12, 2.0.0-beta.13: 2.0.0-beta.13, 2.0.0-rc.0: 2.0.0-rc.0, 2.0.0-rc.1: 2.0.0-rc.1, 2.0.0-rc.2: 2.0.0-rc.2, 2.0.0-rc.3: 2.0.0-rc.3, 2.0.0-rc.4: 2.0.0-rc.4, 2.0.0-rc.5: 2.0.0-rc.5, 2.0.0-rc.6: 2.0.0-rc.6, 2.0.0-rc.7: 2.0.0-rc.7, 2.0.0-rc.8: 2.0.0-rc.8, 2.0.0-rc.9: 2.0.0-rc.9, 2.0.0-rc.10: 2.0.0-rc.10, 2.0.0-rc.11: 2.0.0-rc.11, 2.0.0-rc.12: 2.0.0-rc.12, 2.0.0-rc.14: 2.0.0-rc.14, 2.0.0-rc.16: 2.0.0-rc.16, 2.0.0-rc.18: 2.0.0-rc.18, legacy: 1.3.6, 2.4.0-alpha.0: 2.4.0-alpha.0, v2.4.0-alpha.2: 2.4.0-alpha.2

参考: 文档 — API 参考，指南 • GitHub Issues — 错误、解决方法、边界情况 • GitHub Discussions — 问答、模式、示例 • 版本发布 — 更新日志、破坏性变更、新 API

API 变更

本节记录了特定版本的 API 变更 — 请优先关注近期的主要/次要版本发布。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

🇺🇸English

vuejs/test-utils `@vue/test-utils`

Version: 2.4.6 Deps: js-beautify@^1.14.9, vue-component-type-helpers@^2.0.0 Tags: latest: 2.4.6, 2.0.0-alpha.0: 2.0.0-alpha.0, 2.0.0-alpha.1: 2.0.0-alpha.1, 2.0.0-alpha.2: 2.0.0-alpha.2, 2.0.0-alpha.3: 2.0.0-alpha.3, 2.0.0-alpha.4: 2.0.0-alpha.4, next: 2.4.0-alpha.2, 2.0.0-alpha.8: 2.0.0-alpha.8, 2.0.0-beta.1: 2.0.0-beta.1, 2.0.0-beta.2: 2.0.0-beta.2, 2.0.0-beta.3: 2.0.0-beta.3, 2.0.0-beta.4: 2.0.0-beta.4, 2.0.0-beta.5: 2.0.0-beta.5, 2.0.0-beta.7: 2.0.0-beta.7, 2.0.0-beta.8: 2.0.0-beta.8, 2.0.0-beta.9: 2.0.0-beta.9, 2.0.0-beta.10: 2.0.0-beta.10, 2.0.0-beta.12: 2.0.0-beta.12, 2.0.0-beta.13: 2.0.0-beta.13, 2.0.0-rc.0: 2.0.0-rc.0, 2.0.0-rc.1: 2.0.0-rc.1, 2.0.0-rc.2: 2.0.0-rc.2, 2.0.0-rc.3: 2.0.0-rc.3, 2.0.0-rc.4: 2.0.0-rc.4, 2.0.0-rc.5: 2.0.0-rc.5, 2.0.0-rc.6: 2.0.0-rc.6, 2.0.0-rc.7: 2.0.0-rc.7, 2.0.0-rc.8: 2.0.0-rc.8, 2.0.0-rc.9: 2.0.0-rc.9, 2.0.0-rc.10: 2.0.0-rc.10, 2.0.0-rc.11: 2.0.0-rc.11, 2.0.0-rc.12: 2.0.0-rc.12, 2.0.0-rc.14: 2.0.0-rc.14, 2.0.0-rc.16: 2.0.0-rc.16, 2.0.0-rc.18: 2.0.0-rc.18, legacy: 1.3.6, 2.4.0-alpha.0: 2.4.0-alpha.0, v2.4.0-alpha.2: 2.4.0-alpha.2

References: Docs — API reference, guides • GitHub Issues — bugs, workarounds, edge cases • GitHub Discussions — Q&A, patterns, recipes • Releases — changelog, breaking changes, new APIs

API Changes

This section documents version-specific API changes — prioritize recent major/minor releases.

BREAKING: propsData — v2 renamed to props for consistency with component definitions source
BREAKING: createLocalVue — removed in v2, use the global mounting option to install plugins, mixins, or directives source
BREAKING: mocks and stubs — moved into the global mounting option in v2 as they apply to all components source
BREAKING: — renamed to in v2 to match Vue 3 lifecycle naming

Also changed: setValue() and trigger() return nextTick · slots scope exposed as params in string templates · is, isEmpty, isVueInstance, name, setMethods, and contains removed

Best Practices

Always await methods that return nextTick (trigger, setValue, setProps, setData) to ensure DOM updates are processed before running assertions source

// Preferred await wrapper.find('button').trigger('click') expect(wrapper.text()).toContain('Count: 1')

// Avoid — assertion runs before DOM update wrapper.find('button').trigger('click') expect(wrapper.text()).toContain('Count: 1')
Prefer get() and getComponent() over find() and when you expect the element to exist — they throw immediately if not found, providing clearer test failures

Weekly Installs

Repository

harlan-zw/vue-e…m-skills

GitHub Stars

147

First Seen

Feb 19, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

github-copilot51

opencode46

gemini-cli46

claude-code46

codex46

kimi-cli45

Vue 3 调试指南：解决响应式、计算属性与监听器常见错误

11,900 周安装

BREAKING: findAll().at() — removed in v2; findAll() now returns a standard array of wrappers source

BREAKING: createWrapper() — removed in v2, use the new DOMWrapper() constructor for non-component elements source

BREAKING: shallowMount — v2 no longer renders default slot content for stubbed components by default source

BREAKING: find() — now only supports querySelector syntax; use findComponent() to locate Vue components source

BREAKING: setSelected and setChecked — removed in v2, functionality merged into setValue() source

BREAKING: attachToDocument — renamed to attachTo in v2 source

BREAKING: emittedByOrder — removed in v2, use emitted() instead source

NEW: renderToString() — added in v2.3.0 to support SSR testing source

NEW: enableAutoUnmount() / disableAutoUnmount() — replaces enableAutoDestroy in v2 source

DEPRECATED: scopedSlots — removed in v2 and merged into the slots mounting option source

Use flushPromises() to resolve non-Vue asynchronous operations such as mocked API calls (axios) or external promise-based logic that Vue doesn't track source

Enable enableAutoUnmount(afterEach) in your test setup to automatically clean up wrappers after every test, preventing state pollution and memory leaks source

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

enableAutoUnmount(afterEach)

Wrap components with async setup() in a <Suspense> component within your test to correctly handle their asynchronous initialization source

Enable config.global.renderStubDefaultSlot = true when using shallow mounting to ensure content within default slots is rendered for verification source

Prefer mount() with specific global.stubs over shallow: true to keep tests more production-like while still isolating specific complex child components source

Use global.provide to pass data to components using inject, ensuring the component tree's dependency injection works as it does in production source

Test complex composables by mounting a minimal TestComponent that calls the composable, allowing you to verify internal state via wrapper.vm source

const TestComponent = defineComponent({ setup() { return { ...useMyComposable() } } }) const wrapper = mount(TestComponent) expect(wrapper.vm.someValue).toBe(true)

Stub custom directives using the vName naming convention (e.g., vTooltip: true) in the global.stubs mounting option source

Vue Test Utils 2.4.6 官方测试工具：Vue.js 组件单元测试与集成测试指南

🇨🇳中文介绍

vuejs/test-utils `@vue/test-utils`

API 变更

相关 Skills

最佳实践

🇺🇸English

vuejs/test-utils `@vue/test-utils`

API Changes

Best Practices

最新 Skills

Vue Test Utils 2.4.6 官方测试工具：Vue.js 组件单元测试与集成测试指南

🇨🇳中文介绍

vuejs/test-utils @vue/test-utils

API 变更

相关 Skills

最佳实践

🇺🇸English

vuejs/test-utils @vue/test-utils

API Changes

Best Practices

最新 Skills

vuejs/test-utils `@vue/test-utils`

vuejs/test-utils `@vue/test-utils`