Vue 3 组件单元测试指南 (Vitest)
Testing & QualityVue 3 组件单元测试指南 (Vitest) is an Agent Skill for testing & quality published in the TencentBlueKing/bk-bcs repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
使用 Vitest 和 Vue Test Utils 的标准模版与断言技巧
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/TencentBlueKing/bk-bcs/blob/HEAD/bcs-services/bcs-project-manager/.cursor/skills/unit-testing/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/vue-3-组件单元测试指南-vitest, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Vue 3 组件单元测试指南
采用 Vitest 作为测试运行器,配合 @vue/test-utils 进行组件测试。
环境准备
"devDependencies": {
"vitest": "^1.0.0",
"@vue/test-utils": "^2.4.0",
"jsdom": "^23.0.0"
}
测试模版
import { mount } from '@vue/test-utils';
import { describe, it, expect, vi } from 'vitest';
import MyComponent from './MyComponent.vue';
describe('MyComponent.vue', () => {
it('renders properly', () => {
const wrapper = mount(MyComponent, {
props: { title: 'Hello' }
});
expect(wrapper.text()).toContain('Hello');
});
it('emits event on click', async () => {
const wrapper = mount(MyComponent);
await wrapper.find('button').trigger('click');
expect(wrapper.emitted()).toHaveProperty('submit');
});
});
常用技巧
// Mock 第三方组件
const wrapper = mount(MyComponent, {
global: { stubs: { 'bk-table': true } }
});
// Mock API(文件顶部)
vi.mock('@/api/user', () => ({
getUserInfo: vi.fn(() => Promise.resolve({ id: 1 }))
}));
运行测试
npm run test:unit
📦 按需加载资源
| 资源 | URI |
|---|---|
| 完整测试示例 | skill://unit-testing/assets/component.spec.ts |
📦 可用资源
skill://unit-testing/assets/component.spec.ts
根据 SKILL.md 中的 IF-THEN 规则判断是否需要加载