ccjk 14.2.2 → 15.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +1 -1
- package/README.md +75 -338
- package/dist/cli.js +89 -0
- package/dist/cli.js.map +1 -0
- package/dist/commands/detect.js +15 -0
- package/dist/commands/detect.js.map +1 -0
- package/dist/commands/doctor.js +68 -0
- package/dist/commands/doctor.js.map +1 -0
- package/dist/commands/git-install.js +50 -0
- package/dist/commands/git-install.js.map +1 -0
- package/dist/commands/init.js +165 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/mcp.js +66 -0
- package/dist/commands/mcp.js.map +1 -0
- package/dist/commands/menu.js +42 -0
- package/dist/commands/menu.js.map +1 -0
- package/dist/commands/profile.js +138 -0
- package/dist/commands/profile.js.map +1 -0
- package/dist/core/detect.js +24 -0
- package/dist/core/detect.js.map +1 -0
- package/dist/core/lint.js +49 -0
- package/dist/core/lint.js.map +1 -0
- package/dist/core/mcp.js +41 -0
- package/dist/core/mcp.js.map +1 -0
- package/dist/core/paths.js +9 -0
- package/dist/core/paths.js.map +1 -0
- package/dist/core/profiles.js +104 -0
- package/dist/core/profiles.js.map +1 -0
- package/dist/core/providers.js +53 -0
- package/dist/core/providers.js.map +1 -0
- package/dist/core/settings.js +31 -0
- package/dist/core/settings.js.map +1 -0
- package/dist/core/slash-templates.js +56 -0
- package/dist/core/slash-templates.js.map +1 -0
- package/dist/core/tools.js +27 -0
- package/dist/core/tools.js.map +1 -0
- package/package.json +43 -164
- package/README.HONEST.md +0 -176
- package/README.en.md +0 -67
- package/README.ja.md +0 -67
- package/README.ko.md +0 -67
- package/README.zh-CN.md +0 -86
- package/bin/ccjk.mjs +0 -5
- package/bin/ccjk.ts +0 -222
- package/dist/chunks/agent-teams.mjs +0 -145
- package/dist/chunks/agent.mjs +0 -1439
- package/dist/chunks/agents.mjs +0 -3783
- package/dist/chunks/api-cli.mjs +0 -135
- package/dist/chunks/api-config-selector.mjs +0 -159
- package/dist/chunks/api-providers.mjs +0 -144
- package/dist/chunks/api.mjs +0 -115
- package/dist/chunks/auto-bootstrap.mjs +0 -358
- package/dist/chunks/auto-fixer.mjs +0 -95
- package/dist/chunks/auto-updater.mjs +0 -507
- package/dist/chunks/banner.mjs +0 -173
- package/dist/chunks/bash.mjs +0 -187
- package/dist/chunks/boost.mjs +0 -474
- package/dist/chunks/brain-config.mjs +0 -75
- package/dist/chunks/brain-status.mjs +0 -89
- package/dist/chunks/ccjk-agents.mjs +0 -416
- package/dist/chunks/ccjk-all.mjs +0 -1046
- package/dist/chunks/ccjk-config.mjs +0 -445
- package/dist/chunks/ccjk-hooks.mjs +0 -1074
- package/dist/chunks/ccjk-mcp.mjs +0 -763
- package/dist/chunks/ccjk-setup.mjs +0 -765
- package/dist/chunks/ccjk-skills.mjs +0 -518
- package/dist/chunks/ccr.mjs +0 -109
- package/dist/chunks/ccu.mjs +0 -40
- package/dist/chunks/check-updates.mjs +0 -117
- package/dist/chunks/claude-code-incremental-manager.mjs +0 -761
- package/dist/chunks/claude-config.mjs +0 -606
- package/dist/chunks/claude-config2.mjs +0 -62
- package/dist/chunks/claude-wrapper.mjs +0 -85
- package/dist/chunks/clavue-config.mjs +0 -1454
- package/dist/chunks/cleanup-migration.mjs +0 -20
- package/dist/chunks/cli-hook.mjs +0 -4096
- package/dist/chunks/cloud-sync.mjs +0 -29
- package/dist/chunks/code-type-resolver.mjs +0 -880
- package/dist/chunks/codex-config-switch.mjs +0 -452
- package/dist/chunks/codex-provider-manager.mjs +0 -238
- package/dist/chunks/codex-uninstaller.mjs +0 -404
- package/dist/chunks/codex.mjs +0 -2141
- package/dist/chunks/commands.mjs +0 -108
- package/dist/chunks/commands2.mjs +0 -421
- package/dist/chunks/commit.mjs +0 -140
- package/dist/chunks/completion.mjs +0 -517
- package/dist/chunks/config-consolidator.mjs +0 -172
- package/dist/chunks/config-switch.mjs +0 -334
- package/dist/chunks/config.mjs +0 -558
- package/dist/chunks/config2.mjs +0 -484
- package/dist/chunks/config3.mjs +0 -486
- package/dist/chunks/constants.mjs +0 -323
- package/dist/chunks/context-opt.mjs +0 -444
- package/dist/chunks/context.mjs +0 -974
- package/dist/chunks/dashboard.mjs +0 -481
- package/dist/chunks/doctor.mjs +0 -1301
- package/dist/chunks/eval.mjs +0 -502
- package/dist/chunks/evolution.mjs +0 -322
- package/dist/chunks/features.mjs +0 -715
- package/dist/chunks/fish.mjs +0 -181
- package/dist/chunks/fs-operations.mjs +0 -180
- package/dist/chunks/health-alerts.mjs +0 -830
- package/dist/chunks/help.mjs +0 -341
- package/dist/chunks/hook-installer.mjs +0 -48
- package/dist/chunks/impact.mjs +0 -651
- package/dist/chunks/index.mjs +0 -23
- package/dist/chunks/index10.mjs +0 -19
- package/dist/chunks/index11.mjs +0 -1171
- package/dist/chunks/index12.mjs +0 -218
- package/dist/chunks/index13.mjs +0 -679
- package/dist/chunks/index14.mjs +0 -1009
- package/dist/chunks/index15.mjs +0 -194
- package/dist/chunks/index2.mjs +0 -7637
- package/dist/chunks/index3.mjs +0 -171
- package/dist/chunks/index4.mjs +0 -26
- package/dist/chunks/index5.mjs +0 -19
- package/dist/chunks/index6.mjs +0 -19092
- package/dist/chunks/index7.mjs +0 -616
- package/dist/chunks/index8.mjs +0 -1602
- package/dist/chunks/index9.mjs +0 -5384
- package/dist/chunks/init.mjs +0 -1911
- package/dist/chunks/installer.mjs +0 -757
- package/dist/chunks/installer2.mjs +0 -103
- package/dist/chunks/interview.mjs +0 -2927
- package/dist/chunks/json-config.mjs +0 -60
- package/dist/chunks/linux.mjs +0 -3863
- package/dist/chunks/macos.mjs +0 -69
- package/dist/chunks/main.mjs +0 -635
- package/dist/chunks/manager.mjs +0 -1048
- package/dist/chunks/marketplace.mjs +0 -265
- package/dist/chunks/mcp-cli.mjs +0 -205
- package/dist/chunks/mcp-performance.mjs +0 -187
- package/dist/chunks/mcp.mjs +0 -667
- package/dist/chunks/memory-check.mjs +0 -2973
- package/dist/chunks/memory-paths.mjs +0 -259
- package/dist/chunks/memory-sync.mjs +0 -209
- package/dist/chunks/memory.mjs +0 -354
- package/dist/chunks/metrics-display.mjs +0 -153
- package/dist/chunks/monitor.mjs +0 -1856
- package/dist/chunks/notification.mjs +0 -1864
- package/dist/chunks/onboarding.mjs +0 -386
- package/dist/chunks/package.mjs +0 -3
- package/dist/chunks/paradigm.mjs +0 -74
- package/dist/chunks/permission-manager.mjs +0 -250
- package/dist/chunks/permissions.mjs +0 -265
- package/dist/chunks/persistence-manager.mjs +0 -801
- package/dist/chunks/persistence.mjs +0 -707
- package/dist/chunks/platform.mjs +0 -395
- package/dist/chunks/plugin.mjs +0 -1936
- package/dist/chunks/powershell.mjs +0 -213
- package/dist/chunks/prompts.mjs +0 -244
- package/dist/chunks/providers.mjs +0 -263
- package/dist/chunks/quick-actions.mjs +0 -335
- package/dist/chunks/quick-provider.mjs +0 -755
- package/dist/chunks/quick-setup.mjs +0 -421
- package/dist/chunks/remote.mjs +0 -497
- package/dist/chunks/research.mjs +0 -1904
- package/dist/chunks/rollback.mjs +0 -38
- package/dist/chunks/session-manager.mjs +0 -1371
- package/dist/chunks/session.mjs +0 -878
- package/dist/chunks/sessions.mjs +0 -106
- package/dist/chunks/silent-updater.mjs +0 -396
- package/dist/chunks/simple-config.mjs +0 -122
- package/dist/chunks/skill.mjs +0 -117
- package/dist/chunks/skill2.mjs +0 -9052
- package/dist/chunks/skills-sync.mjs +0 -1343
- package/dist/chunks/skills.mjs +0 -577
- package/dist/chunks/slash-commands.mjs +0 -208
- package/dist/chunks/smart-guide.mjs +0 -247
- package/dist/chunks/snapshot.mjs +0 -58
- package/dist/chunks/startup.mjs +0 -487
- package/dist/chunks/stats.mjs +0 -191
- package/dist/chunks/status.mjs +0 -471
- package/dist/chunks/team.mjs +0 -63
- package/dist/chunks/thinking.mjs +0 -626
- package/dist/chunks/trace.mjs +0 -57
- package/dist/chunks/uninstall.mjs +0 -852
- package/dist/chunks/update.mjs +0 -174
- package/dist/chunks/upgrade-manager.mjs +0 -204
- package/dist/chunks/upgrade.mjs +0 -133
- package/dist/chunks/version-checker.mjs +0 -891
- package/dist/chunks/vim.mjs +0 -903
- package/dist/chunks/windows.mjs +0 -14
- package/dist/chunks/workflows.mjs +0 -633
- package/dist/chunks/wsl.mjs +0 -129
- package/dist/chunks/zero-config.mjs +0 -871
- package/dist/chunks/zsh.mjs +0 -182
- package/dist/cli.d.mts +0 -1
- package/dist/cli.d.ts +0 -1
- package/dist/cli.mjs +0 -2684
- package/dist/i18n/locales/en/agent-teams.json +0 -18
- package/dist/i18n/locales/en/agentBrowser.json +0 -80
- package/dist/i18n/locales/en/agents.json +0 -135
- package/dist/i18n/locales/en/api.json +0 -63
- package/dist/i18n/locales/en/ccjk-agents.json +0 -33
- package/dist/i18n/locales/en/ccjk-all.json +0 -23
- package/dist/i18n/locales/en/ccjk-skills.json +0 -22
- package/dist/i18n/locales/en/ccjk.json +0 -276
- package/dist/i18n/locales/en/ccr.json +0 -65
- package/dist/i18n/locales/en/claude-md.json +0 -73
- package/dist/i18n/locales/en/cli.json +0 -148
- package/dist/i18n/locales/en/cloud-setup.json +0 -31
- package/dist/i18n/locales/en/cloud-sync.json +0 -147
- package/dist/i18n/locales/en/cloud.json +0 -40
- package/dist/i18n/locales/en/cloudPlugins.json +0 -118
- package/dist/i18n/locales/en/codex.json +0 -184
- package/dist/i18n/locales/en/cometix.json +0 -29
- package/dist/i18n/locales/en/common.json +0 -68
- package/dist/i18n/locales/en/config.json +0 -108
- package/dist/i18n/locales/en/configuration.json +0 -236
- package/dist/i18n/locales/en/context.json +0 -85
- package/dist/i18n/locales/en/dashboard.json +0 -78
- package/dist/i18n/locales/en/errors.json +0 -26
- package/dist/i18n/locales/en/evolution.json +0 -54
- package/dist/i18n/locales/en/hooks.json +0 -74
- package/dist/i18n/locales/en/hooksSync.json +0 -133
- package/dist/i18n/locales/en/installation.json +0 -83
- package/dist/i18n/locales/en/interview.json +0 -104
- package/dist/i18n/locales/en/language.json +0 -19
- package/dist/i18n/locales/en/lsp.json +0 -78
- package/dist/i18n/locales/en/marketplace.json +0 -116
- package/dist/i18n/locales/en/mcp.json +0 -180
- package/dist/i18n/locales/en/memory.json +0 -23
- package/dist/i18n/locales/en/menu.json +0 -299
- package/dist/i18n/locales/en/multi-config.json +0 -79
- package/dist/i18n/locales/en/notification.json +0 -307
- package/dist/i18n/locales/en/permissions.json +0 -95
- package/dist/i18n/locales/en/persistence.json +0 -127
- package/dist/i18n/locales/en/plugins.json +0 -146
- package/dist/i18n/locales/en/quick-actions.json +0 -78
- package/dist/i18n/locales/en/registry.json +0 -54
- package/dist/i18n/locales/en/remote.json +0 -93
- package/dist/i18n/locales/en/sandbox.json +0 -44
- package/dist/i18n/locales/en/setup.json +0 -44
- package/dist/i18n/locales/en/shencha.json +0 -14
- package/dist/i18n/locales/en/skills.json +0 -100
- package/dist/i18n/locales/en/skillsSync.json +0 -74
- package/dist/i18n/locales/en/smartGuide.json +0 -49
- package/dist/i18n/locales/en/stats.json +0 -20
- package/dist/i18n/locales/en/subagent.json +0 -69
- package/dist/i18n/locales/en/superpowers.json +0 -117
- package/dist/i18n/locales/en/team.json +0 -7
- package/dist/i18n/locales/en/thinking.json +0 -65
- package/dist/i18n/locales/en/tools.json +0 -42
- package/dist/i18n/locales/en/uninstall.json +0 -56
- package/dist/i18n/locales/en/updater.json +0 -29
- package/dist/i18n/locales/en/vim.json +0 -169
- package/dist/i18n/locales/en/workflow.json +0 -55
- package/dist/i18n/locales/en/workspace.json +0 -108
- package/dist/i18n/locales/zh-CN/agent-teams.json +0 -18
- package/dist/i18n/locales/zh-CN/agentBrowser.json +0 -80
- package/dist/i18n/locales/zh-CN/agents.json +0 -135
- package/dist/i18n/locales/zh-CN/api.json +0 -63
- package/dist/i18n/locales/zh-CN/ccjk-agents.json +0 -33
- package/dist/i18n/locales/zh-CN/ccjk-all.json +0 -23
- package/dist/i18n/locales/zh-CN/ccjk-skills.json +0 -22
- package/dist/i18n/locales/zh-CN/ccjk.json +0 -276
- package/dist/i18n/locales/zh-CN/ccr.json +0 -65
- package/dist/i18n/locales/zh-CN/claude-md.json +0 -73
- package/dist/i18n/locales/zh-CN/cli.json +0 -148
- package/dist/i18n/locales/zh-CN/cloud-setup.json +0 -31
- package/dist/i18n/locales/zh-CN/cloud-sync.json +0 -147
- package/dist/i18n/locales/zh-CN/cloud.json +0 -40
- package/dist/i18n/locales/zh-CN/cloudPlugins.json +0 -118
- package/dist/i18n/locales/zh-CN/codex.json +0 -184
- package/dist/i18n/locales/zh-CN/cometix.json +0 -29
- package/dist/i18n/locales/zh-CN/common.json +0 -68
- package/dist/i18n/locales/zh-CN/config.json +0 -108
- package/dist/i18n/locales/zh-CN/configuration.json +0 -234
- package/dist/i18n/locales/zh-CN/context.json +0 -85
- package/dist/i18n/locales/zh-CN/dashboard.json +0 -78
- package/dist/i18n/locales/zh-CN/errors.json +0 -26
- package/dist/i18n/locales/zh-CN/evolution.json +0 -54
- package/dist/i18n/locales/zh-CN/hooks.json +0 -74
- package/dist/i18n/locales/zh-CN/hooksSync.json +0 -133
- package/dist/i18n/locales/zh-CN/installation.json +0 -83
- package/dist/i18n/locales/zh-CN/interview.json +0 -104
- package/dist/i18n/locales/zh-CN/language.json +0 -19
- package/dist/i18n/locales/zh-CN/lsp.json +0 -78
- package/dist/i18n/locales/zh-CN/marketplace.json +0 -116
- package/dist/i18n/locales/zh-CN/mcp.json +0 -180
- package/dist/i18n/locales/zh-CN/memory.json +0 -23
- package/dist/i18n/locales/zh-CN/menu.json +0 -299
- package/dist/i18n/locales/zh-CN/multi-config.json +0 -79
- package/dist/i18n/locales/zh-CN/notification.json +0 -307
- package/dist/i18n/locales/zh-CN/permissions.json +0 -95
- package/dist/i18n/locales/zh-CN/persistence.json +0 -127
- package/dist/i18n/locales/zh-CN/plugins.json +0 -146
- package/dist/i18n/locales/zh-CN/quick-actions.json +0 -78
- package/dist/i18n/locales/zh-CN/registry.json +0 -54
- package/dist/i18n/locales/zh-CN/remote.json +0 -93
- package/dist/i18n/locales/zh-CN/sandbox.json +0 -44
- package/dist/i18n/locales/zh-CN/setup.json +0 -44
- package/dist/i18n/locales/zh-CN/shencha.json +0 -14
- package/dist/i18n/locales/zh-CN/skills.json +0 -100
- package/dist/i18n/locales/zh-CN/skillsSync.json +0 -74
- package/dist/i18n/locales/zh-CN/smartGuide.json +0 -49
- package/dist/i18n/locales/zh-CN/stats.json +0 -20
- package/dist/i18n/locales/zh-CN/subagent.json +0 -69
- package/dist/i18n/locales/zh-CN/superpowers.json +0 -117
- package/dist/i18n/locales/zh-CN/team.json +0 -7
- package/dist/i18n/locales/zh-CN/thinking.json +0 -65
- package/dist/i18n/locales/zh-CN/tools.json +0 -42
- package/dist/i18n/locales/zh-CN/uninstall.json +0 -56
- package/dist/i18n/locales/zh-CN/updater.json +0 -29
- package/dist/i18n/locales/zh-CN/vim.json +0 -169
- package/dist/i18n/locales/zh-CN/workflow.json +0 -55
- package/dist/i18n/locales/zh-CN/workspace.json +0 -108
- package/dist/index.d.mts +0 -5658
- package/dist/index.d.ts +0 -5658
- package/dist/index.mjs +0 -3732
- package/dist/shared/ccjk.5bEolFrk.mjs +0 -254
- package/dist/shared/ccjk.8oaxX4iR.mjs +0 -90
- package/dist/shared/ccjk.B2U7DsPy.mjs +0 -31
- package/dist/shared/ccjk.B2f-cwUP.mjs +0 -468
- package/dist/shared/ccjk.BAGoDD49.mjs +0 -36
- package/dist/shared/ccjk.BBtCGd_g.mjs +0 -899
- package/dist/shared/ccjk.BFQ7yr5S.mjs +0 -16
- package/dist/shared/ccjk.BLsIiTqO.mjs +0 -449
- package/dist/shared/ccjk.BXv8aYs1.mjs +0 -170
- package/dist/shared/ccjk.BnsY5WxD.mjs +0 -171
- package/dist/shared/ccjk.BoApaI4j.mjs +0 -28
- package/dist/shared/ccjk.Bq8TqZG_.mjs +0 -189
- package/dist/shared/ccjk.BtrioX1Z.mjs +0 -25
- package/dist/shared/ccjk.Bx_rmYfN.mjs +0 -69
- package/dist/shared/ccjk.BzPbSEP2.mjs +0 -115
- package/dist/shared/ccjk.C0WLUnFV.mjs +0 -293
- package/dist/shared/ccjk.C1hANZTu.mjs +0 -19
- package/dist/shared/ccjk.C2jHOZVP.mjs +0 -52
- package/dist/shared/ccjk.CNhnT6uQ.mjs +0 -636
- package/dist/shared/ccjk.COweQ1RR.mjs +0 -5
- package/dist/shared/ccjk.CfKKcvWy.mjs +0 -126
- package/dist/shared/ccjk.Cjgrln_h.mjs +0 -297
- package/dist/shared/ccjk.CoCHVXl3.mjs +0 -3951
- package/dist/shared/ccjk.CwGZSTAK.mjs +0 -319
- package/dist/shared/ccjk.CxpGa6MC.mjs +0 -2724
- package/dist/shared/ccjk.D-magaEx.mjs +0 -763
- package/dist/shared/ccjk.D0g2ABGg.mjs +0 -171
- package/dist/shared/ccjk.D6ycHbak.mjs +0 -270
- package/dist/shared/ccjk.D75wivnp.mjs +0 -142
- package/dist/shared/ccjk.DDL-4C-k.mjs +0 -100
- package/dist/shared/ccjk.DFRPtmK_.mjs +0 -75
- package/dist/shared/ccjk.DMV3x5Sd.mjs +0 -299
- package/dist/shared/ccjk.DZ2LLOa-.mjs +0 -2195
- package/dist/shared/ccjk.DbigonEQ.mjs +0 -698
- package/dist/shared/ccjk.DcMvE7lf.mjs +0 -618
- package/dist/shared/ccjk.DeWpAShp.mjs +0 -1828
- package/dist/shared/ccjk.DhJ1kyDR.mjs +0 -30
- package/dist/shared/ccjk.DlTXS9rP.mjs +0 -224
- package/dist/shared/ccjk.DopKzo3z.mjs +0 -305
- package/dist/shared/ccjk.DsZsc4LR.mjs +0 -1280
- package/dist/shared/ccjk.DuzJZlgj.mjs +0 -418
- package/dist/shared/ccjk.Dxgd2vjc.mjs +0 -444
- package/dist/shared/ccjk.J8YiPsOw.mjs +0 -259
- package/dist/shared/ccjk.KfSWcGlE.mjs +0 -38
- package/dist/shared/ccjk.L7yC58_i.mjs +0 -225
- package/dist/shared/ccjk.MwtjAULc.mjs +0 -1447
- package/dist/shared/ccjk.OJKHVSOb.mjs +0 -2005
- package/dist/shared/ccjk.OTnevPNE.mjs +0 -225
- package/dist/shared/ccjk.RyizuzOI.mjs +0 -21
- package/dist/shared/ccjk.T_cX87dY.mjs +0 -15
- package/dist/shared/ccjk.bQ7Dh1g4.mjs +0 -249
- package/dist/shared/ccjk.gDEDGD_t.mjs +0 -38
- package/dist/shared/ccjk.hoqrwWdN.mjs +0 -333
- package/dist/shared/ccjk.i_vn-9C3.mjs +0 -317
- package/dist/shared/ccjk.lG3ccFjm.mjs +0 -885
- package/dist/shared/ccjk.wLJHO0Af.mjs +0 -244
- package/dist/shared/ccjk.y-a_1vK4.mjs +0 -5127
- package/dist/templates/agents/README.md +0 -78
- package/dist/templates/agents/fullstack-developer.json +0 -70
- package/dist/templates/agents/go-expert.json +0 -69
- package/dist/templates/agents/index.json +0 -64
- package/dist/templates/agents/python-expert.json +0 -69
- package/dist/templates/agents/react-specialist.json +0 -69
- package/dist/templates/agents/testing-automation-expert.json +0 -70
- package/dist/templates/agents/typescript-architect.json +0 -69
- package/dist/templates/claude-code/common/settings.json +0 -109
- package/dist/templates/common/error-prevention.md +0 -267
- package/dist/templates/common/karpathy-baseline.md +0 -83
- package/dist/templates/common/output-styles/zh-CN/carmack-mode.md +0 -381
- package/dist/templates/common/output-styles/zh-CN/codex-rigor-mode.md +0 -114
- package/dist/templates/common/output-styles/zh-CN/dhh-mode.md +0 -265
- package/dist/templates/common/output-styles/zh-CN/evan-you-mode.md +0 -539
- package/dist/templates/common/output-styles/zh-CN/jobs-mode.md +0 -369
- package/dist/templates/common/output-styles/zh-CN/linus-mode.md +0 -135
- package/dist/templates/common/output-styles/zh-CN/uncle-bob-mode.md +0 -221
- package/dist/templates/common/workflow/continuousDelivery/en/continuous-delivery.md +0 -628
- package/dist/templates/common/workflow/continuousDelivery/zh-CN/continuous-delivery.md +0 -628
- package/dist/templates/common/workflow/essential/en/agents/ccjk-config-agent.md +0 -187
- package/dist/templates/common/workflow/essential/en/agents/ccjk-mcp-agent.md +0 -191
- package/dist/templates/common/workflow/essential/en/agents/ccjk-skill-agent.md +0 -249
- package/dist/templates/common/workflow/essential/en/agents/ccjk-workflow-agent.md +0 -277
- package/dist/templates/common/workflow/essential/en/agents/get-current-datetime.md +0 -29
- package/dist/templates/common/workflow/essential/en/agents/init-architect.md +0 -115
- package/dist/templates/common/workflow/essential/en/agents/ui-ux-designer.md +0 -91
- package/dist/templates/common/workflow/essential/en/feat.md +0 -92
- package/dist/templates/common/workflow/essential/en/goal.md +0 -147
- package/dist/templates/common/workflow/essential/en/init-project.md +0 -53
- package/dist/templates/common/workflow/essential/zh-CN/agents/get-current-datetime.md +0 -29
- package/dist/templates/common/workflow/essential/zh-CN/agents/init-architect.md +0 -115
- package/dist/templates/common/workflow/essential/zh-CN/agents/ui-ux-designer.md +0 -91
- package/dist/templates/common/workflow/essential/zh-CN/feat.md +0 -315
- package/dist/templates/common/workflow/essential/zh-CN/goal.md +0 -146
- package/dist/templates/common/workflow/essential/zh-CN/init-project.md +0 -53
- package/dist/templates/common/workflow/git/en/git-cleanBranches.md +0 -102
- package/dist/templates/common/workflow/git/en/git-commit.md +0 -205
- package/dist/templates/common/workflow/git/en/git-rollback.md +0 -90
- package/dist/templates/common/workflow/git/en/git-worktree.md +0 -276
- package/dist/templates/common/workflow/git/zh-CN/git-cleanBranches.md +0 -102
- package/dist/templates/common/workflow/git/zh-CN/git-commit.md +0 -205
- package/dist/templates/common/workflow/git/zh-CN/git-rollback.md +0 -90
- package/dist/templates/common/workflow/git/zh-CN/git-worktree.md +0 -276
- package/dist/templates/common/workflow/interview/en/interview.md +0 -67
- package/dist/templates/common/workflow/interview/zh-CN/interview.md +0 -67
- package/dist/templates/common/workflow/linearMethod/en/linear-method.md +0 -651
- package/dist/templates/common/workflow/linearMethod/zh-CN/linear-method.md +0 -752
- package/dist/templates/common/workflow/refactoringMaster/en/refactoring-master.md +0 -516
- package/dist/templates/common/workflow/refactoringMaster/zh-CN/refactoring-master.md +0 -812
- package/dist/templates/common/workflow/sixStep/en/workflow.md +0 -83
- package/dist/templates/common/workflow/sixStep/zh-CN/workflow.md +0 -359
- package/dist/templates/common/workflow/specFirstTDD/en/spec-first-tdd.md +0 -364
- package/dist/templates/common/workflow/specFirstTDD/zh-CN/spec-first-tdd.md +0 -366
- package/dist/templates/hooks/README.md +0 -212
- package/dist/templates/hooks/git-workflow-hooks.md +0 -551
- package/dist/templates/hooks/post-test/coverage.json +0 -21
- package/dist/templates/hooks/post-test/summary.json +0 -21
- package/dist/templates/hooks/post-test-coverage.md +0 -434
- package/dist/templates/hooks/pre-commit/eslint.json +0 -22
- package/dist/templates/hooks/pre-commit/prettier.json +0 -22
- package/dist/templates/hooks/pre-commit-black.md +0 -274
- package/dist/templates/hooks/pre-commit-eslint.md +0 -153
- package/dist/templates/hooks/pre-commit-gofmt.md +0 -284
- package/dist/templates/hooks/pre-commit-prettier.md +0 -212
- package/dist/templates/hooks/pre-commit-type-check.md +0 -377
- package/dist/templates/skills/ccjk-init.md +0 -154
- package/dist/templates/skills/ccjk-mcp-setup.md +0 -205
- package/dist/templates/skills/ccjk-troubleshoot.md +0 -228
- package/dist/templates/skills/django-patterns.md +0 -1016
- package/dist/templates/skills/git-workflow.md +0 -748
- package/dist/templates/skills/go-idioms.md +0 -963
- package/dist/templates/skills/index.json +0 -132
- package/dist/templates/skills/nextjs-optimization.md +0 -694
- package/dist/templates/skills/python-pep8.md +0 -852
- package/dist/templates/skills/react-patterns.md +0 -686
- package/dist/templates/skills/rust-patterns.md +0 -1057
- package/dist/templates/skills/security-best-practices.md +0 -1413
- package/dist/templates/skills/testing-best-practices.md +0 -1315
- package/dist/templates/skills/ts-best-practices.md +0 -354
- package/templates/agents/README.md +0 -78
- package/templates/agents/fullstack-developer.json +0 -70
- package/templates/agents/go-expert.json +0 -69
- package/templates/agents/index.json +0 -64
- package/templates/agents/python-expert.json +0 -69
- package/templates/agents/react-specialist.json +0 -69
- package/templates/agents/testing-automation-expert.json +0 -70
- package/templates/agents/typescript-architect.json +0 -69
- package/templates/claude-code/common/settings.json +0 -109
- package/templates/common/error-prevention.md +0 -267
- package/templates/common/karpathy-baseline.md +0 -83
- package/templates/common/output-styles/zh-CN/carmack-mode.md +0 -381
- package/templates/common/output-styles/zh-CN/codex-rigor-mode.md +0 -114
- package/templates/common/output-styles/zh-CN/dhh-mode.md +0 -265
- package/templates/common/output-styles/zh-CN/evan-you-mode.md +0 -539
- package/templates/common/output-styles/zh-CN/jobs-mode.md +0 -369
- package/templates/common/output-styles/zh-CN/linus-mode.md +0 -135
- package/templates/common/output-styles/zh-CN/uncle-bob-mode.md +0 -221
- package/templates/common/workflow/continuousDelivery/en/continuous-delivery.md +0 -628
- package/templates/common/workflow/continuousDelivery/zh-CN/continuous-delivery.md +0 -628
- package/templates/common/workflow/essential/en/agents/ccjk-config-agent.md +0 -187
- package/templates/common/workflow/essential/en/agents/ccjk-mcp-agent.md +0 -191
- package/templates/common/workflow/essential/en/agents/ccjk-skill-agent.md +0 -249
- package/templates/common/workflow/essential/en/agents/ccjk-workflow-agent.md +0 -277
- package/templates/common/workflow/essential/en/agents/get-current-datetime.md +0 -29
- package/templates/common/workflow/essential/en/agents/init-architect.md +0 -115
- package/templates/common/workflow/essential/en/agents/ui-ux-designer.md +0 -91
- package/templates/common/workflow/essential/en/feat.md +0 -92
- package/templates/common/workflow/essential/en/goal.md +0 -147
- package/templates/common/workflow/essential/en/init-project.md +0 -53
- package/templates/common/workflow/essential/zh-CN/agents/get-current-datetime.md +0 -29
- package/templates/common/workflow/essential/zh-CN/agents/init-architect.md +0 -115
- package/templates/common/workflow/essential/zh-CN/agents/ui-ux-designer.md +0 -91
- package/templates/common/workflow/essential/zh-CN/feat.md +0 -315
- package/templates/common/workflow/essential/zh-CN/goal.md +0 -146
- package/templates/common/workflow/essential/zh-CN/init-project.md +0 -53
- package/templates/common/workflow/git/en/git-cleanBranches.md +0 -102
- package/templates/common/workflow/git/en/git-commit.md +0 -205
- package/templates/common/workflow/git/en/git-rollback.md +0 -90
- package/templates/common/workflow/git/en/git-worktree.md +0 -276
- package/templates/common/workflow/git/zh-CN/git-cleanBranches.md +0 -102
- package/templates/common/workflow/git/zh-CN/git-commit.md +0 -205
- package/templates/common/workflow/git/zh-CN/git-rollback.md +0 -90
- package/templates/common/workflow/git/zh-CN/git-worktree.md +0 -276
- package/templates/common/workflow/interview/en/interview.md +0 -67
- package/templates/common/workflow/interview/zh-CN/interview.md +0 -67
- package/templates/common/workflow/linearMethod/en/linear-method.md +0 -651
- package/templates/common/workflow/linearMethod/zh-CN/linear-method.md +0 -752
- package/templates/common/workflow/refactoringMaster/en/refactoring-master.md +0 -516
- package/templates/common/workflow/refactoringMaster/zh-CN/refactoring-master.md +0 -812
- package/templates/common/workflow/sixStep/en/workflow.md +0 -83
- package/templates/common/workflow/sixStep/zh-CN/workflow.md +0 -359
- package/templates/common/workflow/specFirstTDD/en/spec-first-tdd.md +0 -364
- package/templates/common/workflow/specFirstTDD/zh-CN/spec-first-tdd.md +0 -366
- package/templates/hooks/README.md +0 -212
- package/templates/hooks/git-workflow-hooks.md +0 -551
- package/templates/hooks/post-test/coverage.json +0 -21
- package/templates/hooks/post-test/summary.json +0 -21
- package/templates/hooks/post-test-coverage.md +0 -434
- package/templates/hooks/pre-commit/eslint.json +0 -22
- package/templates/hooks/pre-commit/prettier.json +0 -22
- package/templates/hooks/pre-commit-black.md +0 -274
- package/templates/hooks/pre-commit-eslint.md +0 -153
- package/templates/hooks/pre-commit-gofmt.md +0 -284
- package/templates/hooks/pre-commit-prettier.md +0 -212
- package/templates/hooks/pre-commit-type-check.md +0 -377
- package/templates/skills/basic.hbs +0 -72
- package/templates/skills/ccjk-init.md +0 -154
- package/templates/skills/ccjk-mcp-setup.md +0 -205
- package/templates/skills/ccjk-troubleshoot.md +0 -228
- package/templates/skills/code-refactor.hbs +0 -133
- package/templates/skills/code-review.hbs +0 -141
- package/templates/skills/django-patterns.md +0 -1016
- package/templates/skills/git-workflow.md +0 -748
- package/templates/skills/go-idioms.md +0 -963
- package/templates/skills/index.json +0 -132
- package/templates/skills/nextjs-optimization.md +0 -694
- package/templates/skills/python-pep8.md +0 -852
- package/templates/skills/react-patterns.md +0 -686
- package/templates/skills/rust-patterns.md +0 -1057
- package/templates/skills/security-best-practices.md +0 -1413
- package/templates/skills/testing-best-practices.md +0 -1315
- package/templates/skills/ts-best-practices.md +0 -354
- package/templates/skills/type-fix.hbs +0 -132
|
@@ -1,1315 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: testing-best-practices
|
|
3
|
-
description: TDD workflow, test organization, mocking strategies, and comprehensive testing approaches
|
|
4
|
-
description_zh: TDD 工作流、测试组织、模拟策略和全面测试方法
|
|
5
|
-
version: 1.0.0
|
|
6
|
-
category: testing
|
|
7
|
-
triggers: ['/testing-best-practices', '/tdd', '/testing', '/test-patterns']
|
|
8
|
-
use_when:
|
|
9
|
-
- Implementing test-driven development workflows
|
|
10
|
-
- Organizing test suites and improving test coverage
|
|
11
|
-
- Setting up mocking and testing strategies
|
|
12
|
-
- Code review for testing practices
|
|
13
|
-
use_when_zh:
|
|
14
|
-
- 实现测试驱动开发工作流
|
|
15
|
-
- 组织测试套件和提高测试覆盖率
|
|
16
|
-
- 设置模拟和测试策略
|
|
17
|
-
- 测试实践代码审查
|
|
18
|
-
auto_activate: true
|
|
19
|
-
priority: 8
|
|
20
|
-
agents: [testing-expert, qa-engineer]
|
|
21
|
-
tags: [testing, tdd, mocking, coverage, quality-assurance]
|
|
22
|
-
---
|
|
23
|
-
|
|
24
|
-
# Testing Best Practices | 测试最佳实践
|
|
25
|
-
|
|
26
|
-
## Context | 上下文
|
|
27
|
-
|
|
28
|
-
Use this skill when implementing comprehensive testing strategies, following TDD principles, and ensuring high-quality code through effective testing practices. Essential for maintainable and reliable software development.
|
|
29
|
-
|
|
30
|
-
在实现全面测试策略、遵循 TDD 原则并通过有效测试实践确保高质量代码时使用此技能。对于可维护和可靠的软件开发至关重要。
|
|
31
|
-
|
|
32
|
-
## Test-Driven Development (TDD) | 测试驱动开发
|
|
33
|
-
|
|
34
|
-
### 1. TDD Cycle: Red-Green-Refactor | TDD 循环:红-绿-重构
|
|
35
|
-
|
|
36
|
-
```javascript
|
|
37
|
-
// ✅ Good: TDD Example - Building a Calculator
|
|
38
|
-
|
|
39
|
-
// Step 1: RED - Write failing test first
|
|
40
|
-
describe('Calculator', () => {
|
|
41
|
-
describe('add', () => {
|
|
42
|
-
it('should add two positive numbers', () => {
|
|
43
|
-
const calculator = new Calculator();
|
|
44
|
-
const result = calculator.add(2, 3);
|
|
45
|
-
expect(result).toBe(5);
|
|
46
|
-
});
|
|
47
|
-
|
|
48
|
-
it('should handle negative numbers', () => {
|
|
49
|
-
const calculator = new Calculator();
|
|
50
|
-
const result = calculator.add(-2, 3);
|
|
51
|
-
expect(result).toBe(1);
|
|
52
|
-
});
|
|
53
|
-
|
|
54
|
-
it('should handle zero', () => {
|
|
55
|
-
const calculator = new Calculator();
|
|
56
|
-
const result = calculator.add(0, 5);
|
|
57
|
-
expect(result).toBe(5);
|
|
58
|
-
});
|
|
59
|
-
|
|
60
|
-
it('should handle decimal numbers', () => {
|
|
61
|
-
const calculator = new Calculator();
|
|
62
|
-
const result = calculator.add(0.1, 0.2);
|
|
63
|
-
expect(result).toBeCloseTo(0.3);
|
|
64
|
-
});
|
|
65
|
-
});
|
|
66
|
-
|
|
67
|
-
describe('divide', () => {
|
|
68
|
-
it('should divide two numbers', () => {
|
|
69
|
-
const calculator = new Calculator();
|
|
70
|
-
const result = calculator.divide(10, 2);
|
|
71
|
-
expect(result).toBe(5);
|
|
72
|
-
});
|
|
73
|
-
|
|
74
|
-
it('should throw error when dividing by zero', () => {
|
|
75
|
-
const calculator = new Calculator();
|
|
76
|
-
expect(() => calculator.divide(10, 0)).toThrow('Division by zero');
|
|
77
|
-
});
|
|
78
|
-
|
|
79
|
-
it('should handle decimal division', () => {
|
|
80
|
-
const calculator = new Calculator();
|
|
81
|
-
const result = calculator.divide(1, 3);
|
|
82
|
-
expect(result).toBeCloseTo(0.333, 3);
|
|
83
|
-
});
|
|
84
|
-
});
|
|
85
|
-
});
|
|
86
|
-
|
|
87
|
-
// Step 2: GREEN - Write minimal code to make tests pass
|
|
88
|
-
class Calculator {
|
|
89
|
-
add(a, b) {
|
|
90
|
-
return a + b;
|
|
91
|
-
}
|
|
92
|
-
|
|
93
|
-
divide(a, b) {
|
|
94
|
-
if (b === 0) {
|
|
95
|
-
throw new Error('Division by zero');
|
|
96
|
-
}
|
|
97
|
-
return a / b;
|
|
98
|
-
}
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
// Step 3: REFACTOR - Improve code while keeping tests green
|
|
102
|
-
class Calculator {
|
|
103
|
-
add(a, b) {
|
|
104
|
-
this._validateNumbers(a, b);
|
|
105
|
-
return a + b;
|
|
106
|
-
}
|
|
107
|
-
|
|
108
|
-
subtract(a, b) {
|
|
109
|
-
this._validateNumbers(a, b);
|
|
110
|
-
return a - b;
|
|
111
|
-
}
|
|
112
|
-
|
|
113
|
-
multiply(a, b) {
|
|
114
|
-
this._validateNumbers(a, b);
|
|
115
|
-
return a * b;
|
|
116
|
-
}
|
|
117
|
-
|
|
118
|
-
divide(a, b) {
|
|
119
|
-
this._validateNumbers(a, b);
|
|
120
|
-
if (b === 0) {
|
|
121
|
-
throw new Error('Division by zero');
|
|
122
|
-
}
|
|
123
|
-
return a / b;
|
|
124
|
-
}
|
|
125
|
-
|
|
126
|
-
_validateNumbers(...numbers) {
|
|
127
|
-
for (const num of numbers) {
|
|
128
|
-
if (typeof num !== 'number' || isNaN(num)) {
|
|
129
|
-
throw new Error('Invalid number provided');
|
|
130
|
-
}
|
|
131
|
-
}
|
|
132
|
-
}
|
|
133
|
-
}
|
|
134
|
-
|
|
135
|
-
// ✅ Good: TDD for User Service
|
|
136
|
-
describe('UserService', () => {
|
|
137
|
-
let userService;
|
|
138
|
-
let mockRepository;
|
|
139
|
-
|
|
140
|
-
beforeEach(() => {
|
|
141
|
-
mockRepository = {
|
|
142
|
-
findById: jest.fn(),
|
|
143
|
-
save: jest.fn(),
|
|
144
|
-
findByEmail: jest.fn(),
|
|
145
|
-
};
|
|
146
|
-
userService = new UserService(mockRepository);
|
|
147
|
-
});
|
|
148
|
-
|
|
149
|
-
describe('createUser', () => {
|
|
150
|
-
it('should create a user with valid data', async () => {
|
|
151
|
-
// Arrange
|
|
152
|
-
const userData = {
|
|
153
|
-
name: 'John Doe',
|
|
154
|
-
email: 'john@example.com',
|
|
155
|
-
age: 30
|
|
156
|
-
};
|
|
157
|
-
const expectedUser = { id: 1, ...userData };
|
|
158
|
-
|
|
159
|
-
mockRepository.findByEmail.mockResolvedValue(null);
|
|
160
|
-
mockRepository.save.mockResolvedValue(expectedUser);
|
|
161
|
-
|
|
162
|
-
// Act
|
|
163
|
-
const result = await userService.createUser(userData);
|
|
164
|
-
|
|
165
|
-
// Assert
|
|
166
|
-
expect(result).toEqual(expectedUser);
|
|
167
|
-
expect(mockRepository.findByEmail).toHaveBeenCalledWith('john@example.com');
|
|
168
|
-
expect(mockRepository.save).toHaveBeenCalledWith(userData);
|
|
169
|
-
});
|
|
170
|
-
|
|
171
|
-
it('should throw error if email already exists', async () => {
|
|
172
|
-
// Arrange
|
|
173
|
-
const userData = {
|
|
174
|
-
name: 'John Doe',
|
|
175
|
-
email: 'john@example.com',
|
|
176
|
-
age: 30
|
|
177
|
-
};
|
|
178
|
-
const existingUser = { id: 2, ...userData };
|
|
179
|
-
|
|
180
|
-
mockRepository.findByEmail.mockResolvedValue(existingUser);
|
|
181
|
-
|
|
182
|
-
// Act & Assert
|
|
183
|
-
await expect(userService.createUser(userData))
|
|
184
|
-
.rejects
|
|
185
|
-
.toThrow('Email already exists');
|
|
186
|
-
|
|
187
|
-
expect(mockRepository.save).not.toHaveBeenCalled();
|
|
188
|
-
});
|
|
189
|
-
|
|
190
|
-
it('should validate required fields', async () => {
|
|
191
|
-
// Arrange
|
|
192
|
-
const invalidUserData = {
|
|
193
|
-
name: '',
|
|
194
|
-
email: 'john@example.com',
|
|
195
|
-
age: 30
|
|
196
|
-
};
|
|
197
|
-
|
|
198
|
-
// Act & Assert
|
|
199
|
-
await expect(userService.createUser(invalidUserData))
|
|
200
|
-
.rejects
|
|
201
|
-
.toThrow('Name is required');
|
|
202
|
-
|
|
203
|
-
expect(mockRepository.findByEmail).not.toHaveBeenCalled();
|
|
204
|
-
expect(mockRepository.save).not.toHaveBeenCalled();
|
|
205
|
-
});
|
|
206
|
-
});
|
|
207
|
-
});
|
|
208
|
-
|
|
209
|
-
// Implementation following TDD
|
|
210
|
-
class UserService {
|
|
211
|
-
constructor(repository) {
|
|
212
|
-
this.repository = repository;
|
|
213
|
-
}
|
|
214
|
-
|
|
215
|
-
async createUser(userData) {
|
|
216
|
-
// Validation
|
|
217
|
-
if (!userData.name || userData.name.trim() === '') {
|
|
218
|
-
throw new Error('Name is required');
|
|
219
|
-
}
|
|
220
|
-
|
|
221
|
-
if (!userData.email || !this._isValidEmail(userData.email)) {
|
|
222
|
-
throw new Error('Valid email is required');
|
|
223
|
-
}
|
|
224
|
-
|
|
225
|
-
if (!userData.age || userData.age < 0) {
|
|
226
|
-
throw new Error('Valid age is required');
|
|
227
|
-
}
|
|
228
|
-
|
|
229
|
-
// Check for existing user
|
|
230
|
-
const existingUser = await this.repository.findByEmail(userData.email);
|
|
231
|
-
if (existingUser) {
|
|
232
|
-
throw new Error('Email already exists');
|
|
233
|
-
}
|
|
234
|
-
|
|
235
|
-
// Save user
|
|
236
|
-
return await this.repository.save(userData);
|
|
237
|
-
}
|
|
238
|
-
|
|
239
|
-
_isValidEmail(email) {
|
|
240
|
-
const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
|
|
241
|
-
return emailRegex.test(email);
|
|
242
|
-
}
|
|
243
|
-
}
|
|
244
|
-
```
|
|
245
|
-
|
|
246
|
-
### 2. Test Organization and Structure | 测试组织和结构
|
|
247
|
-
|
|
248
|
-
```javascript
|
|
249
|
-
// ✅ Good: Well-organized test structure
|
|
250
|
-
|
|
251
|
-
// tests/unit/services/UserService.test.js
|
|
252
|
-
describe('UserService', () => {
|
|
253
|
-
// Setup and teardown
|
|
254
|
-
let userService;
|
|
255
|
-
let mockRepository;
|
|
256
|
-
let mockEmailService;
|
|
257
|
-
let mockLogger;
|
|
258
|
-
|
|
259
|
-
beforeEach(() => {
|
|
260
|
-
// Fresh mocks for each test
|
|
261
|
-
mockRepository = createMockRepository();
|
|
262
|
-
mockEmailService = createMockEmailService();
|
|
263
|
-
mockLogger = createMockLogger();
|
|
264
|
-
|
|
265
|
-
userService = new UserService(mockRepository, mockEmailService, mockLogger);
|
|
266
|
-
});
|
|
267
|
-
|
|
268
|
-
afterEach(() => {
|
|
269
|
-
// Cleanup if needed
|
|
270
|
-
jest.clearAllMocks();
|
|
271
|
-
});
|
|
272
|
-
|
|
273
|
-
// Group related tests
|
|
274
|
-
describe('User Creation', () => {
|
|
275
|
-
describe('when valid data is provided', () => {
|
|
276
|
-
it('should create user successfully', async () => {
|
|
277
|
-
// Test implementation
|
|
278
|
-
});
|
|
279
|
-
|
|
280
|
-
it('should send welcome email', async () => {
|
|
281
|
-
// Test implementation
|
|
282
|
-
});
|
|
283
|
-
|
|
284
|
-
it('should log user creation', async () => {
|
|
285
|
-
// Test implementation
|
|
286
|
-
});
|
|
287
|
-
});
|
|
288
|
-
|
|
289
|
-
describe('when invalid data is provided', () => {
|
|
290
|
-
it('should reject empty name', async () => {
|
|
291
|
-
// Test implementation
|
|
292
|
-
});
|
|
293
|
-
|
|
294
|
-
it('should reject invalid email format', async () => {
|
|
295
|
-
// Test implementation
|
|
296
|
-
});
|
|
297
|
-
|
|
298
|
-
it('should reject negative age', async () => {
|
|
299
|
-
// Test implementation
|
|
300
|
-
});
|
|
301
|
-
});
|
|
302
|
-
|
|
303
|
-
describe('when email already exists', () => {
|
|
304
|
-
it('should throw appropriate error', async () => {
|
|
305
|
-
// Test implementation
|
|
306
|
-
});
|
|
307
|
-
|
|
308
|
-
it('should not send welcome email', async () => {
|
|
309
|
-
// Test implementation
|
|
310
|
-
});
|
|
311
|
-
});
|
|
312
|
-
});
|
|
313
|
-
|
|
314
|
-
describe('User Retrieval', () => {
|
|
315
|
-
describe('when user exists', () => {
|
|
316
|
-
it('should return user data', async () => {
|
|
317
|
-
// Test implementation
|
|
318
|
-
});
|
|
319
|
-
|
|
320
|
-
it('should not include sensitive data', async () => {
|
|
321
|
-
// Test implementation
|
|
322
|
-
});
|
|
323
|
-
});
|
|
324
|
-
|
|
325
|
-
describe('when user does not exist', () => {
|
|
326
|
-
it('should return null', async () => {
|
|
327
|
-
// Test implementation
|
|
328
|
-
});
|
|
329
|
-
|
|
330
|
-
it('should log access attempt', async () => {
|
|
331
|
-
// Test implementation
|
|
332
|
-
});
|
|
333
|
-
});
|
|
334
|
-
});
|
|
335
|
-
});
|
|
336
|
-
|
|
337
|
-
// ✅ Good: Test helpers and utilities
|
|
338
|
-
// tests/helpers/mockFactories.js
|
|
339
|
-
export function createMockRepository() {
|
|
340
|
-
return {
|
|
341
|
-
findById: jest.fn(),
|
|
342
|
-
findByEmail: jest.fn(),
|
|
343
|
-
save: jest.fn(),
|
|
344
|
-
update: jest.fn(),
|
|
345
|
-
delete: jest.fn(),
|
|
346
|
-
};
|
|
347
|
-
}
|
|
348
|
-
|
|
349
|
-
export function createMockEmailService() {
|
|
350
|
-
return {
|
|
351
|
-
sendWelcomeEmail: jest.fn(),
|
|
352
|
-
sendPasswordResetEmail: jest.fn(),
|
|
353
|
-
};
|
|
354
|
-
}
|
|
355
|
-
|
|
356
|
-
export function createMockLogger() {
|
|
357
|
-
return {
|
|
358
|
-
info: jest.fn(),
|
|
359
|
-
warn: jest.fn(),
|
|
360
|
-
error: jest.fn(),
|
|
361
|
-
};
|
|
362
|
-
}
|
|
363
|
-
|
|
364
|
-
// tests/helpers/testData.js
|
|
365
|
-
export const validUserData = {
|
|
366
|
-
name: 'John Doe',
|
|
367
|
-
email: 'john@example.com',
|
|
368
|
-
age: 30,
|
|
369
|
-
};
|
|
370
|
-
|
|
371
|
-
export const invalidUserData = {
|
|
372
|
-
emptyName: { ...validUserData, name: '' },
|
|
373
|
-
invalidEmail: { ...validUserData, email: 'invalid-email' },
|
|
374
|
-
negativeAge: { ...validUserData, age: -5 },
|
|
375
|
-
};
|
|
376
|
-
|
|
377
|
-
export function createUser(overrides = {}) {
|
|
378
|
-
return {
|
|
379
|
-
id: 1,
|
|
380
|
-
...validUserData,
|
|
381
|
-
createdAt: new Date(),
|
|
382
|
-
updatedAt: new Date(),
|
|
383
|
-
...overrides,
|
|
384
|
-
};
|
|
385
|
-
}
|
|
386
|
-
|
|
387
|
-
// ✅ Good: Custom matchers for better assertions
|
|
388
|
-
// tests/helpers/customMatchers.js
|
|
389
|
-
expect.extend({
|
|
390
|
-
toBeValidUser(received) {
|
|
391
|
-
const pass = received &&
|
|
392
|
-
typeof received.id === 'number' &&
|
|
393
|
-
typeof received.name === 'string' &&
|
|
394
|
-
typeof received.email === 'string' &&
|
|
395
|
-
received.email.includes('@') &&
|
|
396
|
-
typeof received.age === 'number' &&
|
|
397
|
-
received.age >= 0;
|
|
398
|
-
|
|
399
|
-
if (pass) {
|
|
400
|
-
return {
|
|
401
|
-
message: () => `expected ${received} not to be a valid user`,
|
|
402
|
-
pass: true,
|
|
403
|
-
};
|
|
404
|
-
} else {
|
|
405
|
-
return {
|
|
406
|
-
message: () => `expected ${received} to be a valid user`,
|
|
407
|
-
pass: false,
|
|
408
|
-
};
|
|
409
|
-
}
|
|
410
|
-
},
|
|
411
|
-
|
|
412
|
-
toHaveBeenCalledWithValidUser(received) {
|
|
413
|
-
const calls = received.mock.calls;
|
|
414
|
-
const pass = calls.some(call => {
|
|
415
|
-
const user = call[0];
|
|
416
|
-
return user && typeof user.name === 'string' && user.name.length > 0;
|
|
417
|
-
});
|
|
418
|
-
|
|
419
|
-
return {
|
|
420
|
-
message: () => pass
|
|
421
|
-
? `expected function not to have been called with valid user`
|
|
422
|
-
: `expected function to have been called with valid user`,
|
|
423
|
-
pass,
|
|
424
|
-
};
|
|
425
|
-
},
|
|
426
|
-
});
|
|
427
|
-
```
|
|
428
|
-
|
|
429
|
-
## Mocking and Test Doubles | 模拟和测试替身
|
|
430
|
-
|
|
431
|
-
### 1. Mocking Strategies | 模拟策略
|
|
432
|
-
|
|
433
|
-
```javascript
|
|
434
|
-
// ✅ Good: Different types of test doubles
|
|
435
|
-
|
|
436
|
-
// Dummy - objects passed around but never used
|
|
437
|
-
class DummyLogger {
|
|
438
|
-
info() {}
|
|
439
|
-
warn() {}
|
|
440
|
-
error() {}
|
|
441
|
-
}
|
|
442
|
-
|
|
443
|
-
// Fake - working implementation with shortcuts
|
|
444
|
-
class FakeUserRepository {
|
|
445
|
-
constructor() {
|
|
446
|
-
this.users = new Map();
|
|
447
|
-
this.nextId = 1;
|
|
448
|
-
}
|
|
449
|
-
|
|
450
|
-
async save(user) {
|
|
451
|
-
const id = this.nextId++;
|
|
452
|
-
const savedUser = { ...user, id };
|
|
453
|
-
this.users.set(id, savedUser);
|
|
454
|
-
return savedUser;
|
|
455
|
-
}
|
|
456
|
-
|
|
457
|
-
async findById(id) {
|
|
458
|
-
return this.users.get(id) || null;
|
|
459
|
-
}
|
|
460
|
-
|
|
461
|
-
async findByEmail(email) {
|
|
462
|
-
for (const user of this.users.values()) {
|
|
463
|
-
if (user.email === email) {
|
|
464
|
-
return user;
|
|
465
|
-
}
|
|
466
|
-
}
|
|
467
|
-
return null;
|
|
468
|
-
}
|
|
469
|
-
|
|
470
|
-
clear() {
|
|
471
|
-
this.users.clear();
|
|
472
|
-
this.nextId = 1;
|
|
473
|
-
}
|
|
474
|
-
}
|
|
475
|
-
|
|
476
|
-
// Stub - provides canned answers
|
|
477
|
-
class StubEmailService {
|
|
478
|
-
constructor(shouldSucceed = true) {
|
|
479
|
-
this.shouldSucceed = shouldSucceed;
|
|
480
|
-
this.sentEmails = [];
|
|
481
|
-
}
|
|
482
|
-
|
|
483
|
-
async sendWelcomeEmail(user) {
|
|
484
|
-
this.sentEmails.push({
|
|
485
|
-
to: user.email,
|
|
486
|
-
type: 'welcome',
|
|
487
|
-
timestamp: new Date(),
|
|
488
|
-
});
|
|
489
|
-
|
|
490
|
-
if (!this.shouldSucceed) {
|
|
491
|
-
throw new Error('Email service unavailable');
|
|
492
|
-
}
|
|
493
|
-
|
|
494
|
-
return { messageId: 'fake-message-id' };
|
|
495
|
-
}
|
|
496
|
-
|
|
497
|
-
getSentEmails() {
|
|
498
|
-
return [...this.sentEmails];
|
|
499
|
-
}
|
|
500
|
-
}
|
|
501
|
-
|
|
502
|
-
// Mock - objects with expectations
|
|
503
|
-
describe('UserService with different test doubles', () => {
|
|
504
|
-
describe('using Fake repository', () => {
|
|
505
|
-
let userService;
|
|
506
|
-
let fakeRepository;
|
|
507
|
-
|
|
508
|
-
beforeEach(() => {
|
|
509
|
-
fakeRepository = new FakeUserRepository();
|
|
510
|
-
userService = new UserService(fakeRepository, new DummyLogger());
|
|
511
|
-
});
|
|
512
|
-
|
|
513
|
-
afterEach(() => {
|
|
514
|
-
fakeRepository.clear();
|
|
515
|
-
});
|
|
516
|
-
|
|
517
|
-
it('should persist user data', async () => {
|
|
518
|
-
const userData = { name: 'John', email: 'john@example.com', age: 30 };
|
|
519
|
-
|
|
520
|
-
const createdUser = await userService.createUser(userData);
|
|
521
|
-
const retrievedUser = await userService.getUserById(createdUser.id);
|
|
522
|
-
|
|
523
|
-
expect(retrievedUser).toEqual(createdUser);
|
|
524
|
-
});
|
|
525
|
-
});
|
|
526
|
-
|
|
527
|
-
describe('using Stub email service', () => {
|
|
528
|
-
let userService;
|
|
529
|
-
let stubEmailService;
|
|
530
|
-
|
|
531
|
-
beforeEach(() => {
|
|
532
|
-
stubEmailService = new StubEmailService();
|
|
533
|
-
userService = new UserService(
|
|
534
|
-
new FakeUserRepository(),
|
|
535
|
-
stubEmailService,
|
|
536
|
-
new DummyLogger()
|
|
537
|
-
);
|
|
538
|
-
});
|
|
539
|
-
|
|
540
|
-
it('should send welcome email on user creation', async () => {
|
|
541
|
-
const userData = { name: 'John', email: 'john@example.com', age: 30 };
|
|
542
|
-
|
|
543
|
-
await userService.createUser(userData);
|
|
544
|
-
|
|
545
|
-
const sentEmails = stubEmailService.getSentEmails();
|
|
546
|
-
expect(sentEmails).toHaveLength(1);
|
|
547
|
-
expect(sentEmails[0].to).toBe('john@example.com');
|
|
548
|
-
expect(sentEmails[0].type).toBe('welcome');
|
|
549
|
-
});
|
|
550
|
-
});
|
|
551
|
-
|
|
552
|
-
describe('using Mock with Jest', () => {
|
|
553
|
-
let userService;
|
|
554
|
-
let mockRepository;
|
|
555
|
-
let mockEmailService;
|
|
556
|
-
|
|
557
|
-
beforeEach(() => {
|
|
558
|
-
mockRepository = {
|
|
559
|
-
save: jest.fn(),
|
|
560
|
-
findById: jest.fn(),
|
|
561
|
-
findByEmail: jest.fn(),
|
|
562
|
-
};
|
|
563
|
-
|
|
564
|
-
mockEmailService = {
|
|
565
|
-
sendWelcomeEmail: jest.fn(),
|
|
566
|
-
};
|
|
567
|
-
|
|
568
|
-
userService = new UserService(mockRepository, mockEmailService);
|
|
569
|
-
});
|
|
570
|
-
|
|
571
|
-
it('should call repository and email service with correct parameters', async () => {
|
|
572
|
-
const userData = { name: 'John', email: 'john@example.com', age: 30 };
|
|
573
|
-
const savedUser = { id: 1, ...userData };
|
|
574
|
-
|
|
575
|
-
mockRepository.findByEmail.mockResolvedValue(null);
|
|
576
|
-
mockRepository.save.mockResolvedValue(savedUser);
|
|
577
|
-
mockEmailService.sendWelcomeEmail.mockResolvedValue({ messageId: 'test' });
|
|
578
|
-
|
|
579
|
-
await userService.createUser(userData);
|
|
580
|
-
|
|
581
|
-
expect(mockRepository.findByEmail).toHaveBeenCalledWith('john@example.com');
|
|
582
|
-
expect(mockRepository.save).toHaveBeenCalledWith(userData);
|
|
583
|
-
expect(mockEmailService.sendWelcomeEmail).toHaveBeenCalledWith(savedUser);
|
|
584
|
-
});
|
|
585
|
-
});
|
|
586
|
-
});
|
|
587
|
-
|
|
588
|
-
// ✅ Good: Mocking external dependencies
|
|
589
|
-
describe('WeatherService', () => {
|
|
590
|
-
let weatherService;
|
|
591
|
-
let mockHttpClient;
|
|
592
|
-
|
|
593
|
-
beforeEach(() => {
|
|
594
|
-
mockHttpClient = {
|
|
595
|
-
get: jest.fn(),
|
|
596
|
-
};
|
|
597
|
-
weatherService = new WeatherService(mockHttpClient);
|
|
598
|
-
});
|
|
599
|
-
|
|
600
|
-
it('should fetch weather data from API', async () => {
|
|
601
|
-
const mockWeatherData = {
|
|
602
|
-
temperature: 25,
|
|
603
|
-
humidity: 60,
|
|
604
|
-
conditions: 'sunny',
|
|
605
|
-
};
|
|
606
|
-
|
|
607
|
-
mockHttpClient.get.mockResolvedValue({
|
|
608
|
-
data: mockWeatherData,
|
|
609
|
-
status: 200,
|
|
610
|
-
});
|
|
611
|
-
|
|
612
|
-
const result = await weatherService.getCurrentWeather('New York');
|
|
613
|
-
|
|
614
|
-
expect(mockHttpClient.get).toHaveBeenCalledWith(
|
|
615
|
-
'https://api.weather.com/current',
|
|
616
|
-
{ params: { city: 'New York' } }
|
|
617
|
-
);
|
|
618
|
-
expect(result).toEqual(mockWeatherData);
|
|
619
|
-
});
|
|
620
|
-
|
|
621
|
-
it('should handle API errors gracefully', async () => {
|
|
622
|
-
mockHttpClient.get.mockRejectedValue(new Error('Network error'));
|
|
623
|
-
|
|
624
|
-
await expect(weatherService.getCurrentWeather('New York'))
|
|
625
|
-
.rejects
|
|
626
|
-
.toThrow('Failed to fetch weather data');
|
|
627
|
-
});
|
|
628
|
-
|
|
629
|
-
it('should retry on temporary failures', async () => {
|
|
630
|
-
mockHttpClient.get
|
|
631
|
-
.mockRejectedValueOnce(new Error('Temporary error'))
|
|
632
|
-
.mockRejectedValueOnce(new Error('Temporary error'))
|
|
633
|
-
.mockResolvedValue({ data: { temperature: 20 }, status: 200 });
|
|
634
|
-
|
|
635
|
-
const result = await weatherService.getCurrentWeather('London');
|
|
636
|
-
|
|
637
|
-
expect(mockHttpClient.get).toHaveBeenCalledTimes(3);
|
|
638
|
-
expect(result.temperature).toBe(20);
|
|
639
|
-
});
|
|
640
|
-
});
|
|
641
|
-
```
|
|
642
|
-
|
|
643
|
-
### 2. Integration Testing | 集成测试
|
|
644
|
-
|
|
645
|
-
```javascript
|
|
646
|
-
// ✅ Good: Integration tests with real dependencies
|
|
647
|
-
|
|
648
|
-
// tests/integration/UserService.integration.test.js
|
|
649
|
-
describe('UserService Integration Tests', () => {
|
|
650
|
-
let userService;
|
|
651
|
-
let database;
|
|
652
|
-
let emailService;
|
|
653
|
-
|
|
654
|
-
beforeAll(async () => {
|
|
655
|
-
// Setup test database
|
|
656
|
-
database = await setupTestDatabase();
|
|
657
|
-
emailService = new EmailService({
|
|
658
|
-
provider: 'test',
|
|
659
|
-
apiKey: 'test-key',
|
|
660
|
-
});
|
|
661
|
-
|
|
662
|
-
userService = new UserService(
|
|
663
|
-
new UserRepository(database),
|
|
664
|
-
emailService,
|
|
665
|
-
new Logger({ level: 'silent' })
|
|
666
|
-
);
|
|
667
|
-
});
|
|
668
|
-
|
|
669
|
-
afterAll(async () => {
|
|
670
|
-
await teardownTestDatabase(database);
|
|
671
|
-
});
|
|
672
|
-
|
|
673
|
-
beforeEach(async () => {
|
|
674
|
-
await clearTestData(database);
|
|
675
|
-
});
|
|
676
|
-
|
|
677
|
-
describe('User lifecycle', () => {
|
|
678
|
-
it('should handle complete user creation flow', async () => {
|
|
679
|
-
const userData = {
|
|
680
|
-
name: 'Integration Test User',
|
|
681
|
-
email: 'integration@test.com',
|
|
682
|
-
age: 25,
|
|
683
|
-
};
|
|
684
|
-
|
|
685
|
-
// Create user
|
|
686
|
-
const createdUser = await userService.createUser(userData);
|
|
687
|
-
expect(createdUser.id).toBeDefined();
|
|
688
|
-
expect(createdUser.name).toBe(userData.name);
|
|
689
|
-
|
|
690
|
-
// Verify user exists in database
|
|
691
|
-
const retrievedUser = await userService.getUserById(createdUser.id);
|
|
692
|
-
expect(retrievedUser).toEqual(createdUser);
|
|
693
|
-
|
|
694
|
-
// Verify email was sent
|
|
695
|
-
const sentEmails = await emailService.getSentEmails();
|
|
696
|
-
expect(sentEmails).toHaveLength(1);
|
|
697
|
-
expect(sentEmails[0].to).toBe(userData.email);
|
|
698
|
-
});
|
|
699
|
-
|
|
700
|
-
it('should handle user update flow', async () => {
|
|
701
|
-
// Create user first
|
|
702
|
-
const user = await userService.createUser({
|
|
703
|
-
name: 'Original Name',
|
|
704
|
-
email: 'original@test.com',
|
|
705
|
-
age: 30,
|
|
706
|
-
});
|
|
707
|
-
|
|
708
|
-
// Update user
|
|
709
|
-
const updatedData = {
|
|
710
|
-
name: 'Updated Name',
|
|
711
|
-
age: 31,
|
|
712
|
-
};
|
|
713
|
-
|
|
714
|
-
const updatedUser = await userService.updateUser(user.id, updatedData);
|
|
715
|
-
|
|
716
|
-
expect(updatedUser.name).toBe('Updated Name');
|
|
717
|
-
expect(updatedUser.age).toBe(31);
|
|
718
|
-
expect(updatedUser.email).toBe('original@test.com'); // Unchanged
|
|
719
|
-
|
|
720
|
-
// Verify in database
|
|
721
|
-
const retrievedUser = await userService.getUserById(user.id);
|
|
722
|
-
expect(retrievedUser.name).toBe('Updated Name');
|
|
723
|
-
});
|
|
724
|
-
});
|
|
725
|
-
|
|
726
|
-
describe('Error scenarios', () => {
|
|
727
|
-
it('should handle database connection failures', async () => {
|
|
728
|
-
// Simulate database failure
|
|
729
|
-
await database.close();
|
|
730
|
-
|
|
731
|
-
await expect(userService.createUser({
|
|
732
|
-
name: 'Test User',
|
|
733
|
-
email: 'test@example.com',
|
|
734
|
-
age: 25,
|
|
735
|
-
})).rejects.toThrow('Database connection failed');
|
|
736
|
-
|
|
737
|
-
// Restore connection for cleanup
|
|
738
|
-
database = await setupTestDatabase();
|
|
739
|
-
});
|
|
740
|
-
});
|
|
741
|
-
});
|
|
742
|
-
|
|
743
|
-
// ✅ Good: API integration tests
|
|
744
|
-
describe('User API Integration', () => {
|
|
745
|
-
let app;
|
|
746
|
-
let server;
|
|
747
|
-
let database;
|
|
748
|
-
|
|
749
|
-
beforeAll(async () => {
|
|
750
|
-
database = await setupTestDatabase();
|
|
751
|
-
app = createApp({ database });
|
|
752
|
-
server = app.listen(0); // Random port
|
|
753
|
-
});
|
|
754
|
-
|
|
755
|
-
afterAll(async () => {
|
|
756
|
-
await server.close();
|
|
757
|
-
await teardownTestDatabase(database);
|
|
758
|
-
});
|
|
759
|
-
|
|
760
|
-
beforeEach(async () => {
|
|
761
|
-
await clearTestData(database);
|
|
762
|
-
});
|
|
763
|
-
|
|
764
|
-
describe('POST /users', () => {
|
|
765
|
-
it('should create user via API', async () => {
|
|
766
|
-
const userData = {
|
|
767
|
-
name: 'API Test User',
|
|
768
|
-
email: 'api@test.com',
|
|
769
|
-
age: 28,
|
|
770
|
-
};
|
|
771
|
-
|
|
772
|
-
const response = await request(app)
|
|
773
|
-
.post('/users')
|
|
774
|
-
.send(userData)
|
|
775
|
-
.expect(201);
|
|
776
|
-
|
|
777
|
-
expect(response.body.user.name).toBe(userData.name);
|
|
778
|
-
expect(response.body.user.id).toBeDefined();
|
|
779
|
-
|
|
780
|
-
// Verify in database
|
|
781
|
-
const user = await database.users.findById(response.body.user.id);
|
|
782
|
-
expect(user).toBeTruthy();
|
|
783
|
-
});
|
|
784
|
-
|
|
785
|
-
it('should return validation errors', async () => {
|
|
786
|
-
const invalidData = {
|
|
787
|
-
name: '',
|
|
788
|
-
email: 'invalid-email',
|
|
789
|
-
age: -5,
|
|
790
|
-
};
|
|
791
|
-
|
|
792
|
-
const response = await request(app)
|
|
793
|
-
.post('/users')
|
|
794
|
-
.send(invalidData)
|
|
795
|
-
.expect(400);
|
|
796
|
-
|
|
797
|
-
expect(response.body.errors).toHaveLength(3);
|
|
798
|
-
expect(response.body.errors).toContainEqual({
|
|
799
|
-
field: 'name',
|
|
800
|
-
message: 'Name is required',
|
|
801
|
-
});
|
|
802
|
-
});
|
|
803
|
-
});
|
|
804
|
-
|
|
805
|
-
describe('GET /users/:id', () => {
|
|
806
|
-
it('should retrieve user by ID', async () => {
|
|
807
|
-
// Create user first
|
|
808
|
-
const user = await database.users.create({
|
|
809
|
-
name: 'Retrieve Test User',
|
|
810
|
-
email: 'retrieve@test.com',
|
|
811
|
-
age: 35,
|
|
812
|
-
});
|
|
813
|
-
|
|
814
|
-
const response = await request(app)
|
|
815
|
-
.get(`/users/${user.id}`)
|
|
816
|
-
.expect(200);
|
|
817
|
-
|
|
818
|
-
expect(response.body.user.name).toBe(user.name);
|
|
819
|
-
expect(response.body.user.email).toBe(user.email);
|
|
820
|
-
});
|
|
821
|
-
|
|
822
|
-
it('should return 404 for non-existent user', async () => {
|
|
823
|
-
const response = await request(app)
|
|
824
|
-
.get('/users/999999')
|
|
825
|
-
.expect(404);
|
|
826
|
-
|
|
827
|
-
expect(response.body.error).toBe('User not found');
|
|
828
|
-
});
|
|
829
|
-
});
|
|
830
|
-
});
|
|
831
|
-
```
|
|
832
|
-
|
|
833
|
-
## Test Coverage and Quality | 测试覆盖率和质量
|
|
834
|
-
|
|
835
|
-
### 1. Coverage Strategies | 覆盖率策略
|
|
836
|
-
|
|
837
|
-
```javascript
|
|
838
|
-
// ✅ Good: Comprehensive test coverage
|
|
839
|
-
|
|
840
|
-
// jest.config.js
|
|
841
|
-
module.exports = {
|
|
842
|
-
collectCoverage: true,
|
|
843
|
-
coverageDirectory: 'coverage',
|
|
844
|
-
coverageReporters: ['text', 'lcov', 'html'],
|
|
845
|
-
coverageThreshold: {
|
|
846
|
-
global: {
|
|
847
|
-
branches: 80,
|
|
848
|
-
functions: 80,
|
|
849
|
-
lines: 80,
|
|
850
|
-
statements: 80,
|
|
851
|
-
},
|
|
852
|
-
'./src/services/': {
|
|
853
|
-
branches: 90,
|
|
854
|
-
functions: 90,
|
|
855
|
-
lines: 90,
|
|
856
|
-
statements: 90,
|
|
857
|
-
},
|
|
858
|
-
},
|
|
859
|
-
collectCoverageFrom: [
|
|
860
|
-
'src/**/*.{js,jsx}',
|
|
861
|
-
'!src/**/*.test.{js,jsx}',
|
|
862
|
-
'!src/index.js',
|
|
863
|
-
'!src/config/*.js',
|
|
864
|
-
],
|
|
865
|
-
};
|
|
866
|
-
|
|
867
|
-
// ✅ Good: Testing edge cases and error paths
|
|
868
|
-
describe('PaymentProcessor', () => {
|
|
869
|
-
let paymentProcessor;
|
|
870
|
-
let mockPaymentGateway;
|
|
871
|
-
|
|
872
|
-
beforeEach(() => {
|
|
873
|
-
mockPaymentGateway = {
|
|
874
|
-
processPayment: jest.fn(),
|
|
875
|
-
refundPayment: jest.fn(),
|
|
876
|
-
};
|
|
877
|
-
paymentProcessor = new PaymentProcessor(mockPaymentGateway);
|
|
878
|
-
});
|
|
879
|
-
|
|
880
|
-
describe('processPayment', () => {
|
|
881
|
-
// Happy path
|
|
882
|
-
it('should process valid payment successfully', async () => {
|
|
883
|
-
const paymentData = {
|
|
884
|
-
amount: 100.00,
|
|
885
|
-
currency: 'USD',
|
|
886
|
-
cardNumber: '4111111111111111',
|
|
887
|
-
expiryMonth: 12,
|
|
888
|
-
expiryYear: 2025,
|
|
889
|
-
cvv: '123',
|
|
890
|
-
};
|
|
891
|
-
|
|
892
|
-
mockPaymentGateway.processPayment.mockResolvedValue({
|
|
893
|
-
transactionId: 'txn_123',
|
|
894
|
-
status: 'success',
|
|
895
|
-
});
|
|
896
|
-
|
|
897
|
-
const result = await paymentProcessor.processPayment(paymentData);
|
|
898
|
-
|
|
899
|
-
expect(result.success).toBe(true);
|
|
900
|
-
expect(result.transactionId).toBe('txn_123');
|
|
901
|
-
});
|
|
902
|
-
|
|
903
|
-
// Edge cases
|
|
904
|
-
it('should handle minimum payment amount', async () => {
|
|
905
|
-
const paymentData = {
|
|
906
|
-
amount: 0.01, // Minimum amount
|
|
907
|
-
currency: 'USD',
|
|
908
|
-
cardNumber: '4111111111111111',
|
|
909
|
-
expiryMonth: 12,
|
|
910
|
-
expiryYear: 2025,
|
|
911
|
-
cvv: '123',
|
|
912
|
-
};
|
|
913
|
-
|
|
914
|
-
mockPaymentGateway.processPayment.mockResolvedValue({
|
|
915
|
-
transactionId: 'txn_124',
|
|
916
|
-
status: 'success',
|
|
917
|
-
});
|
|
918
|
-
|
|
919
|
-
const result = await paymentProcessor.processPayment(paymentData);
|
|
920
|
-
expect(result.success).toBe(true);
|
|
921
|
-
});
|
|
922
|
-
|
|
923
|
-
it('should reject zero amount', async () => {
|
|
924
|
-
const paymentData = {
|
|
925
|
-
amount: 0,
|
|
926
|
-
currency: 'USD',
|
|
927
|
-
cardNumber: '4111111111111111',
|
|
928
|
-
expiryMonth: 12,
|
|
929
|
-
expiryYear: 2025,
|
|
930
|
-
cvv: '123',
|
|
931
|
-
};
|
|
932
|
-
|
|
933
|
-
await expect(paymentProcessor.processPayment(paymentData))
|
|
934
|
-
.rejects
|
|
935
|
-
.toThrow('Amount must be greater than zero');
|
|
936
|
-
});
|
|
937
|
-
|
|
938
|
-
it('should handle expired card', async () => {
|
|
939
|
-
const paymentData = {
|
|
940
|
-
amount: 100.00,
|
|
941
|
-
currency: 'USD',
|
|
942
|
-
cardNumber: '4111111111111111',
|
|
943
|
-
expiryMonth: 1,
|
|
944
|
-
expiryYear: 2020, // Expired
|
|
945
|
-
cvv: '123',
|
|
946
|
-
};
|
|
947
|
-
|
|
948
|
-
await expect(paymentProcessor.processPayment(paymentData))
|
|
949
|
-
.rejects
|
|
950
|
-
.toThrow('Card has expired');
|
|
951
|
-
});
|
|
952
|
-
|
|
953
|
-
// Error paths
|
|
954
|
-
it('should handle gateway timeout', async () => {
|
|
955
|
-
const paymentData = {
|
|
956
|
-
amount: 100.00,
|
|
957
|
-
currency: 'USD',
|
|
958
|
-
cardNumber: '4111111111111111',
|
|
959
|
-
expiryMonth: 12,
|
|
960
|
-
expiryYear: 2025,
|
|
961
|
-
cvv: '123',
|
|
962
|
-
};
|
|
963
|
-
|
|
964
|
-
mockPaymentGateway.processPayment.mockRejectedValue(
|
|
965
|
-
new Error('Gateway timeout')
|
|
966
|
-
);
|
|
967
|
-
|
|
968
|
-
const result = await paymentProcessor.processPayment(paymentData);
|
|
969
|
-
|
|
970
|
-
expect(result.success).toBe(false);
|
|
971
|
-
expect(result.error).toBe('Payment processing failed');
|
|
972
|
-
});
|
|
973
|
-
|
|
974
|
-
it('should handle insufficient funds', async () => {
|
|
975
|
-
const paymentData = {
|
|
976
|
-
amount: 100.00,
|
|
977
|
-
currency: 'USD',
|
|
978
|
-
cardNumber: '4000000000000002', // Declined card
|
|
979
|
-
expiryMonth: 12,
|
|
980
|
-
expiryYear: 2025,
|
|
981
|
-
cvv: '123',
|
|
982
|
-
};
|
|
983
|
-
|
|
984
|
-
mockPaymentGateway.processPayment.mockResolvedValue({
|
|
985
|
-
status: 'declined',
|
|
986
|
-
reason: 'insufficient_funds',
|
|
987
|
-
});
|
|
988
|
-
|
|
989
|
-
const result = await paymentProcessor.processPayment(paymentData);
|
|
990
|
-
|
|
991
|
-
expect(result.success).toBe(false);
|
|
992
|
-
expect(result.reason).toBe('insufficient_funds');
|
|
993
|
-
});
|
|
994
|
-
|
|
995
|
-
// Boundary conditions
|
|
996
|
-
it('should handle maximum payment amount', async () => {
|
|
997
|
-
const paymentData = {
|
|
998
|
-
amount: 999999.99, // Maximum amount
|
|
999
|
-
currency: 'USD',
|
|
1000
|
-
cardNumber: '4111111111111111',
|
|
1001
|
-
expiryMonth: 12,
|
|
1002
|
-
expiryYear: 2025,
|
|
1003
|
-
cvv: '123',
|
|
1004
|
-
};
|
|
1005
|
-
|
|
1006
|
-
mockPaymentGateway.processPayment.mockResolvedValue({
|
|
1007
|
-
transactionId: 'txn_125',
|
|
1008
|
-
status: 'success',
|
|
1009
|
-
});
|
|
1010
|
-
|
|
1011
|
-
const result = await paymentProcessor.processPayment(paymentData);
|
|
1012
|
-
expect(result.success).toBe(true);
|
|
1013
|
-
});
|
|
1014
|
-
|
|
1015
|
-
it('should reject amount exceeding maximum', async () => {
|
|
1016
|
-
const paymentData = {
|
|
1017
|
-
amount: 1000000.00, // Exceeds maximum
|
|
1018
|
-
currency: 'USD',
|
|
1019
|
-
cardNumber: '4111111111111111',
|
|
1020
|
-
expiryMonth: 12,
|
|
1021
|
-
expiryYear: 2025,
|
|
1022
|
-
cvv: '123',
|
|
1023
|
-
};
|
|
1024
|
-
|
|
1025
|
-
await expect(paymentProcessor.processPayment(paymentData))
|
|
1026
|
-
.rejects
|
|
1027
|
-
.toThrow('Amount exceeds maximum limit');
|
|
1028
|
-
});
|
|
1029
|
-
});
|
|
1030
|
-
});
|
|
1031
|
-
|
|
1032
|
-
// ✅ Good: Property-based testing for comprehensive coverage
|
|
1033
|
-
const fc = require('fast-check');
|
|
1034
|
-
|
|
1035
|
-
describe('StringUtils', () => {
|
|
1036
|
-
describe('reverse', () => {
|
|
1037
|
-
it('should reverse any string correctly', () => {
|
|
1038
|
-
fc.assert(fc.property(fc.string(), (str) => {
|
|
1039
|
-
const reversed = StringUtils.reverse(str);
|
|
1040
|
-
const doubleReversed = StringUtils.reverse(reversed);
|
|
1041
|
-
return doubleReversed === str;
|
|
1042
|
-
}));
|
|
1043
|
-
});
|
|
1044
|
-
|
|
1045
|
-
it('should maintain string length', () => {
|
|
1046
|
-
fc.assert(fc.property(fc.string(), (str) => {
|
|
1047
|
-
const reversed = StringUtils.reverse(str);
|
|
1048
|
-
return reversed.length === str.length;
|
|
1049
|
-
}));
|
|
1050
|
-
});
|
|
1051
|
-
});
|
|
1052
|
-
|
|
1053
|
-
describe('isPalindrome', () => {
|
|
1054
|
-
it('should correctly identify palindromes', () => {
|
|
1055
|
-
fc.assert(fc.property(fc.string(), (str) => {
|
|
1056
|
-
const palindrome = str + StringUtils.reverse(str);
|
|
1057
|
-
return StringUtils.isPalindrome(palindrome);
|
|
1058
|
-
}));
|
|
1059
|
-
});
|
|
1060
|
-
});
|
|
1061
|
-
});
|
|
1062
|
-
```
|
|
1063
|
-
|
|
1064
|
-
### 2. Performance and Load Testing | 性能和负载测试
|
|
1065
|
-
|
|
1066
|
-
```javascript
|
|
1067
|
-
// ✅ Good: Performance testing
|
|
1068
|
-
describe('Performance Tests', () => {
|
|
1069
|
-
describe('UserService', () => {
|
|
1070
|
-
let userService;
|
|
1071
|
-
|
|
1072
|
-
beforeEach(() => {
|
|
1073
|
-
userService = new UserService(new FakeUserRepository());
|
|
1074
|
-
});
|
|
1075
|
-
|
|
1076
|
-
it('should handle bulk user creation efficiently', async () => {
|
|
1077
|
-
const startTime = Date.now();
|
|
1078
|
-
const userPromises = [];
|
|
1079
|
-
|
|
1080
|
-
// Create 1000 users concurrently
|
|
1081
|
-
for (let i = 0; i < 1000; i++) {
|
|
1082
|
-
userPromises.push(userService.createUser({
|
|
1083
|
-
name: `User ${i}`,
|
|
1084
|
-
email: `user${i}@example.com`,
|
|
1085
|
-
age: 20 + (i % 50),
|
|
1086
|
-
}));
|
|
1087
|
-
}
|
|
1088
|
-
|
|
1089
|
-
await Promise.all(userPromises);
|
|
1090
|
-
const endTime = Date.now();
|
|
1091
|
-
const duration = endTime - startTime;
|
|
1092
|
-
|
|
1093
|
-
// Should complete within 5 seconds
|
|
1094
|
-
expect(duration).toBeLessThan(5000);
|
|
1095
|
-
});
|
|
1096
|
-
|
|
1097
|
-
it('should maintain performance with large datasets', async () => {
|
|
1098
|
-
// Pre-populate with 10,000 users
|
|
1099
|
-
const users = [];
|
|
1100
|
-
for (let i = 0; i < 10000; i++) {
|
|
1101
|
-
users.push({
|
|
1102
|
-
name: `User ${i}`,
|
|
1103
|
-
email: `user${i}@example.com`,
|
|
1104
|
-
age: 20 + (i % 50),
|
|
1105
|
-
});
|
|
1106
|
-
}
|
|
1107
|
-
|
|
1108
|
-
await Promise.all(users.map(user => userService.createUser(user)));
|
|
1109
|
-
|
|
1110
|
-
// Test search performance
|
|
1111
|
-
const startTime = Date.now();
|
|
1112
|
-
const results = await userService.searchUsers('User 5000');
|
|
1113
|
-
const endTime = Date.now();
|
|
1114
|
-
|
|
1115
|
-
expect(results.length).toBeGreaterThan(0);
|
|
1116
|
-
expect(endTime - startTime).toBeLessThan(100); // Should be fast
|
|
1117
|
-
});
|
|
1118
|
-
});
|
|
1119
|
-
});
|
|
1120
|
-
|
|
1121
|
-
// ✅ Good: Memory leak testing
|
|
1122
|
-
describe('Memory Tests', () => {
|
|
1123
|
-
it('should not leak memory during repeated operations', async () => {
|
|
1124
|
-
const initialMemory = process.memoryUsage().heapUsed;
|
|
1125
|
-
const userService = new UserService(new FakeUserRepository());
|
|
1126
|
-
|
|
1127
|
-
// Perform many operations
|
|
1128
|
-
for (let i = 0; i < 1000; i++) {
|
|
1129
|
-
const user = await userService.createUser({
|
|
1130
|
-
name: `User ${i}`,
|
|
1131
|
-
email: `user${i}@example.com`,
|
|
1132
|
-
age: 25,
|
|
1133
|
-
});
|
|
1134
|
-
|
|
1135
|
-
await userService.getUserById(user.id);
|
|
1136
|
-
await userService.updateUser(user.id, { age: 26 });
|
|
1137
|
-
await userService.deleteUser(user.id);
|
|
1138
|
-
|
|
1139
|
-
// Force garbage collection periodically
|
|
1140
|
-
if (i % 100 === 0 && global.gc) {
|
|
1141
|
-
global.gc();
|
|
1142
|
-
}
|
|
1143
|
-
}
|
|
1144
|
-
|
|
1145
|
-
// Force final garbage collection
|
|
1146
|
-
if (global.gc) {
|
|
1147
|
-
global.gc();
|
|
1148
|
-
}
|
|
1149
|
-
|
|
1150
|
-
const finalMemory = process.memoryUsage().heapUsed;
|
|
1151
|
-
const memoryIncrease = finalMemory - initialMemory;
|
|
1152
|
-
|
|
1153
|
-
// Memory increase should be reasonable (less than 10MB)
|
|
1154
|
-
expect(memoryIncrease).toBeLessThan(10 * 1024 * 1024);
|
|
1155
|
-
});
|
|
1156
|
-
});
|
|
1157
|
-
```
|
|
1158
|
-
|
|
1159
|
-
## Testing Anti-Patterns | 测试反模式
|
|
1160
|
-
|
|
1161
|
-
### 1. Common Testing Mistakes | 常见测试错误
|
|
1162
|
-
|
|
1163
|
-
```javascript
|
|
1164
|
-
// ❌ Bad: Testing implementation details
|
|
1165
|
-
describe('UserService - Bad Examples', () => {
|
|
1166
|
-
it('should call _validateEmail method', async () => {
|
|
1167
|
-
const userService = new UserService();
|
|
1168
|
-
const spy = jest.spyOn(userService, '_validateEmail');
|
|
1169
|
-
|
|
1170
|
-
await userService.createUser({
|
|
1171
|
-
name: 'John',
|
|
1172
|
-
email: 'john@example.com',
|
|
1173
|
-
age: 30,
|
|
1174
|
-
});
|
|
1175
|
-
|
|
1176
|
-
expect(spy).toHaveBeenCalled(); // Testing private method
|
|
1177
|
-
});
|
|
1178
|
-
|
|
1179
|
-
// ✅ Good: Test behavior, not implementation
|
|
1180
|
-
it('should reject invalid email addresses', async () => {
|
|
1181
|
-
const userService = new UserService();
|
|
1182
|
-
|
|
1183
|
-
await expect(userService.createUser({
|
|
1184
|
-
name: 'John',
|
|
1185
|
-
email: 'invalid-email',
|
|
1186
|
-
age: 30,
|
|
1187
|
-
})).rejects.toThrow('Invalid email address');
|
|
1188
|
-
});
|
|
1189
|
-
});
|
|
1190
|
-
|
|
1191
|
-
// ❌ Bad: Fragile tests that break with minor changes
|
|
1192
|
-
describe('UserComponent - Bad Examples', () => {
|
|
1193
|
-
it('should have specific DOM structure', () => {
|
|
1194
|
-
const wrapper = mount(<UserComponent user={mockUser} />);
|
|
1195
|
-
|
|
1196
|
-
expect(wrapper.find('div').at(0).hasClass('user-container')).toBe(true);
|
|
1197
|
-
expect(wrapper.find('span').at(2).text()).toBe(mockUser.name);
|
|
1198
|
-
expect(wrapper.find('button').at(1).prop('onClick')).toBeDefined();
|
|
1199
|
-
});
|
|
1200
|
-
|
|
1201
|
-
// ✅ Good: Test user-visible behavior
|
|
1202
|
-
it('should display user information and allow editing', () => {
|
|
1203
|
-
const mockUser = { name: 'John Doe', email: 'john@example.com' };
|
|
1204
|
-
const onEdit = jest.fn();
|
|
1205
|
-
|
|
1206
|
-
const wrapper = mount(<UserComponent user={mockUser} onEdit={onEdit} />);
|
|
1207
|
-
|
|
1208
|
-
expect(wrapper.text()).toContain('John Doe');
|
|
1209
|
-
expect(wrapper.text()).toContain('john@example.com');
|
|
1210
|
-
|
|
1211
|
-
wrapper.find('[data-testid="edit-button"]').simulate('click');
|
|
1212
|
-
expect(onEdit).toHaveBeenCalledWith(mockUser);
|
|
1213
|
-
});
|
|
1214
|
-
});
|
|
1215
|
-
|
|
1216
|
-
// ❌ Bad: Tests that depend on each other
|
|
1217
|
-
describe('UserService - Bad Test Dependencies', () => {
|
|
1218
|
-
let createdUserId;
|
|
1219
|
-
|
|
1220
|
-
it('should create a user', async () => {
|
|
1221
|
-
const user = await userService.createUser({
|
|
1222
|
-
name: 'John',
|
|
1223
|
-
email: 'john@example.com',
|
|
1224
|
-
age: 30,
|
|
1225
|
-
});
|
|
1226
|
-
createdUserId = user.id; // Storing state between tests
|
|
1227
|
-
});
|
|
1228
|
-
|
|
1229
|
-
it('should retrieve the created user', async () => {
|
|
1230
|
-
const user = await userService.getUserById(createdUserId); // Depends on previous test
|
|
1231
|
-
expect(user.name).toBe('John');
|
|
1232
|
-
});
|
|
1233
|
-
|
|
1234
|
-
// ✅ Good: Independent tests
|
|
1235
|
-
describe('UserService - Good Independent Tests', () => {
|
|
1236
|
-
it('should create a user', async () => {
|
|
1237
|
-
const user = await userService.createUser({
|
|
1238
|
-
name: 'John',
|
|
1239
|
-
email: 'john@example.com',
|
|
1240
|
-
age: 30,
|
|
1241
|
-
});
|
|
1242
|
-
expect(user.id).toBeDefined();
|
|
1243
|
-
expect(user.name).toBe('John');
|
|
1244
|
-
});
|
|
1245
|
-
|
|
1246
|
-
it('should retrieve a user by ID', async () => {
|
|
1247
|
-
// Setup for this specific test
|
|
1248
|
-
const createdUser = await userService.createUser({
|
|
1249
|
-
name: 'Jane',
|
|
1250
|
-
email: 'jane@example.com',
|
|
1251
|
-
age: 25,
|
|
1252
|
-
});
|
|
1253
|
-
|
|
1254
|
-
const retrievedUser = await userService.getUserById(createdUser.id);
|
|
1255
|
-
expect(retrievedUser.name).toBe('Jane');
|
|
1256
|
-
});
|
|
1257
|
-
});
|
|
1258
|
-
});
|
|
1259
|
-
|
|
1260
|
-
// ❌ Bad: Over-mocking
|
|
1261
|
-
describe('OrderService - Over-mocked', () => {
|
|
1262
|
-
it('should calculate total price', () => {
|
|
1263
|
-
const mockItem1 = { getPrice: jest.fn().mockReturnValue(10) };
|
|
1264
|
-
const mockItem2 = { getPrice: jest.fn().mockReturnValue(20) };
|
|
1265
|
-
const mockItems = [mockItem1, mockItem2];
|
|
1266
|
-
|
|
1267
|
-
const total = OrderService.calculateTotal(mockItems);
|
|
1268
|
-
|
|
1269
|
-
expect(total).toBe(30);
|
|
1270
|
-
expect(mockItem1.getPrice).toHaveBeenCalled();
|
|
1271
|
-
expect(mockItem2.getPrice).toHaveBeenCalled();
|
|
1272
|
-
});
|
|
1273
|
-
|
|
1274
|
-
// ✅ Good: Use real objects when possible
|
|
1275
|
-
it('should calculate total price with real items', () => {
|
|
1276
|
-
const items = [
|
|
1277
|
-
new Item('Product 1', 10),
|
|
1278
|
-
new Item('Product 2', 20),
|
|
1279
|
-
];
|
|
1280
|
-
|
|
1281
|
-
const total = OrderService.calculateTotal(items);
|
|
1282
|
-
expect(total).toBe(30);
|
|
1283
|
-
});
|
|
1284
|
-
});
|
|
1285
|
-
```
|
|
1286
|
-
|
|
1287
|
-
## Testing Checklist | 测试检查清单
|
|
1288
|
-
|
|
1289
|
-
- [ ] Tests follow the AAA pattern (Arrange, Act, Assert)
|
|
1290
|
-
- [ ] Each test has a clear, descriptive name
|
|
1291
|
-
- [ ] Tests are independent and can run in any order
|
|
1292
|
-
- [ ] Happy path, edge cases, and error scenarios are covered
|
|
1293
|
-
- [ ] Mocks are used appropriately (not over-mocked)
|
|
1294
|
-
- [ ] Test data is realistic and representative
|
|
1295
|
-
- [ ] Tests focus on behavior, not implementation details
|
|
1296
|
-
- [ ] Code coverage meets established thresholds
|
|
1297
|
-
- [ ] Integration tests cover critical user journeys
|
|
1298
|
-
- [ ] Performance tests validate non-functional requirements
|
|
1299
|
-
- [ ] Tests are maintainable and easy to understand
|
|
1300
|
-
- [ ] Flaky tests are identified and fixed
|
|
1301
|
-
|
|
1302
|
-
## 测试检查清单
|
|
1303
|
-
|
|
1304
|
-
- [ ] 测试遵循 AAA 模式(准备、执行、断言)
|
|
1305
|
-
- [ ] 每个测试都有清晰、描述性的名称
|
|
1306
|
-
- [ ] 测试独立且可以任意顺序运行
|
|
1307
|
-
- [ ] 覆盖正常路径、边界情况和错误场景
|
|
1308
|
-
- [ ] 适当使用模拟(不过度模拟)
|
|
1309
|
-
- [ ] 测试数据真实且具有代表性
|
|
1310
|
-
- [ ] 测试关注行为,而非实现细节
|
|
1311
|
-
- [ ] 代码覆盖率达到既定阈值
|
|
1312
|
-
- [ ] 集成测试覆盖关键用户旅程
|
|
1313
|
-
- [ ] 性能测试验证非功能性需求
|
|
1314
|
-
- [ ] 测试可维护且易于理解
|
|
1315
|
-
- [ ] 识别并修复不稳定的测试
|