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.
Files changed (532) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +75 -338
  3. package/dist/cli.js +89 -0
  4. package/dist/cli.js.map +1 -0
  5. package/dist/commands/detect.js +15 -0
  6. package/dist/commands/detect.js.map +1 -0
  7. package/dist/commands/doctor.js +68 -0
  8. package/dist/commands/doctor.js.map +1 -0
  9. package/dist/commands/git-install.js +50 -0
  10. package/dist/commands/git-install.js.map +1 -0
  11. package/dist/commands/init.js +165 -0
  12. package/dist/commands/init.js.map +1 -0
  13. package/dist/commands/mcp.js +66 -0
  14. package/dist/commands/mcp.js.map +1 -0
  15. package/dist/commands/menu.js +42 -0
  16. package/dist/commands/menu.js.map +1 -0
  17. package/dist/commands/profile.js +138 -0
  18. package/dist/commands/profile.js.map +1 -0
  19. package/dist/core/detect.js +24 -0
  20. package/dist/core/detect.js.map +1 -0
  21. package/dist/core/lint.js +49 -0
  22. package/dist/core/lint.js.map +1 -0
  23. package/dist/core/mcp.js +41 -0
  24. package/dist/core/mcp.js.map +1 -0
  25. package/dist/core/paths.js +9 -0
  26. package/dist/core/paths.js.map +1 -0
  27. package/dist/core/profiles.js +104 -0
  28. package/dist/core/profiles.js.map +1 -0
  29. package/dist/core/providers.js +53 -0
  30. package/dist/core/providers.js.map +1 -0
  31. package/dist/core/settings.js +31 -0
  32. package/dist/core/settings.js.map +1 -0
  33. package/dist/core/slash-templates.js +56 -0
  34. package/dist/core/slash-templates.js.map +1 -0
  35. package/dist/core/tools.js +27 -0
  36. package/dist/core/tools.js.map +1 -0
  37. package/package.json +43 -164
  38. package/README.HONEST.md +0 -176
  39. package/README.en.md +0 -67
  40. package/README.ja.md +0 -67
  41. package/README.ko.md +0 -67
  42. package/README.zh-CN.md +0 -86
  43. package/bin/ccjk.mjs +0 -5
  44. package/bin/ccjk.ts +0 -222
  45. package/dist/chunks/agent-teams.mjs +0 -145
  46. package/dist/chunks/agent.mjs +0 -1439
  47. package/dist/chunks/agents.mjs +0 -3783
  48. package/dist/chunks/api-cli.mjs +0 -135
  49. package/dist/chunks/api-config-selector.mjs +0 -159
  50. package/dist/chunks/api-providers.mjs +0 -144
  51. package/dist/chunks/api.mjs +0 -115
  52. package/dist/chunks/auto-bootstrap.mjs +0 -358
  53. package/dist/chunks/auto-fixer.mjs +0 -95
  54. package/dist/chunks/auto-updater.mjs +0 -507
  55. package/dist/chunks/banner.mjs +0 -173
  56. package/dist/chunks/bash.mjs +0 -187
  57. package/dist/chunks/boost.mjs +0 -474
  58. package/dist/chunks/brain-config.mjs +0 -75
  59. package/dist/chunks/brain-status.mjs +0 -89
  60. package/dist/chunks/ccjk-agents.mjs +0 -416
  61. package/dist/chunks/ccjk-all.mjs +0 -1046
  62. package/dist/chunks/ccjk-config.mjs +0 -445
  63. package/dist/chunks/ccjk-hooks.mjs +0 -1074
  64. package/dist/chunks/ccjk-mcp.mjs +0 -763
  65. package/dist/chunks/ccjk-setup.mjs +0 -765
  66. package/dist/chunks/ccjk-skills.mjs +0 -518
  67. package/dist/chunks/ccr.mjs +0 -109
  68. package/dist/chunks/ccu.mjs +0 -40
  69. package/dist/chunks/check-updates.mjs +0 -117
  70. package/dist/chunks/claude-code-incremental-manager.mjs +0 -761
  71. package/dist/chunks/claude-config.mjs +0 -606
  72. package/dist/chunks/claude-config2.mjs +0 -62
  73. package/dist/chunks/claude-wrapper.mjs +0 -85
  74. package/dist/chunks/clavue-config.mjs +0 -1454
  75. package/dist/chunks/cleanup-migration.mjs +0 -20
  76. package/dist/chunks/cli-hook.mjs +0 -4096
  77. package/dist/chunks/cloud-sync.mjs +0 -29
  78. package/dist/chunks/code-type-resolver.mjs +0 -880
  79. package/dist/chunks/codex-config-switch.mjs +0 -452
  80. package/dist/chunks/codex-provider-manager.mjs +0 -238
  81. package/dist/chunks/codex-uninstaller.mjs +0 -404
  82. package/dist/chunks/codex.mjs +0 -2141
  83. package/dist/chunks/commands.mjs +0 -108
  84. package/dist/chunks/commands2.mjs +0 -421
  85. package/dist/chunks/commit.mjs +0 -140
  86. package/dist/chunks/completion.mjs +0 -517
  87. package/dist/chunks/config-consolidator.mjs +0 -172
  88. package/dist/chunks/config-switch.mjs +0 -334
  89. package/dist/chunks/config.mjs +0 -558
  90. package/dist/chunks/config2.mjs +0 -484
  91. package/dist/chunks/config3.mjs +0 -486
  92. package/dist/chunks/constants.mjs +0 -323
  93. package/dist/chunks/context-opt.mjs +0 -444
  94. package/dist/chunks/context.mjs +0 -974
  95. package/dist/chunks/dashboard.mjs +0 -481
  96. package/dist/chunks/doctor.mjs +0 -1301
  97. package/dist/chunks/eval.mjs +0 -502
  98. package/dist/chunks/evolution.mjs +0 -322
  99. package/dist/chunks/features.mjs +0 -715
  100. package/dist/chunks/fish.mjs +0 -181
  101. package/dist/chunks/fs-operations.mjs +0 -180
  102. package/dist/chunks/health-alerts.mjs +0 -830
  103. package/dist/chunks/help.mjs +0 -341
  104. package/dist/chunks/hook-installer.mjs +0 -48
  105. package/dist/chunks/impact.mjs +0 -651
  106. package/dist/chunks/index.mjs +0 -23
  107. package/dist/chunks/index10.mjs +0 -19
  108. package/dist/chunks/index11.mjs +0 -1171
  109. package/dist/chunks/index12.mjs +0 -218
  110. package/dist/chunks/index13.mjs +0 -679
  111. package/dist/chunks/index14.mjs +0 -1009
  112. package/dist/chunks/index15.mjs +0 -194
  113. package/dist/chunks/index2.mjs +0 -7637
  114. package/dist/chunks/index3.mjs +0 -171
  115. package/dist/chunks/index4.mjs +0 -26
  116. package/dist/chunks/index5.mjs +0 -19
  117. package/dist/chunks/index6.mjs +0 -19092
  118. package/dist/chunks/index7.mjs +0 -616
  119. package/dist/chunks/index8.mjs +0 -1602
  120. package/dist/chunks/index9.mjs +0 -5384
  121. package/dist/chunks/init.mjs +0 -1911
  122. package/dist/chunks/installer.mjs +0 -757
  123. package/dist/chunks/installer2.mjs +0 -103
  124. package/dist/chunks/interview.mjs +0 -2927
  125. package/dist/chunks/json-config.mjs +0 -60
  126. package/dist/chunks/linux.mjs +0 -3863
  127. package/dist/chunks/macos.mjs +0 -69
  128. package/dist/chunks/main.mjs +0 -635
  129. package/dist/chunks/manager.mjs +0 -1048
  130. package/dist/chunks/marketplace.mjs +0 -265
  131. package/dist/chunks/mcp-cli.mjs +0 -205
  132. package/dist/chunks/mcp-performance.mjs +0 -187
  133. package/dist/chunks/mcp.mjs +0 -667
  134. package/dist/chunks/memory-check.mjs +0 -2973
  135. package/dist/chunks/memory-paths.mjs +0 -259
  136. package/dist/chunks/memory-sync.mjs +0 -209
  137. package/dist/chunks/memory.mjs +0 -354
  138. package/dist/chunks/metrics-display.mjs +0 -153
  139. package/dist/chunks/monitor.mjs +0 -1856
  140. package/dist/chunks/notification.mjs +0 -1864
  141. package/dist/chunks/onboarding.mjs +0 -386
  142. package/dist/chunks/package.mjs +0 -3
  143. package/dist/chunks/paradigm.mjs +0 -74
  144. package/dist/chunks/permission-manager.mjs +0 -250
  145. package/dist/chunks/permissions.mjs +0 -265
  146. package/dist/chunks/persistence-manager.mjs +0 -801
  147. package/dist/chunks/persistence.mjs +0 -707
  148. package/dist/chunks/platform.mjs +0 -395
  149. package/dist/chunks/plugin.mjs +0 -1936
  150. package/dist/chunks/powershell.mjs +0 -213
  151. package/dist/chunks/prompts.mjs +0 -244
  152. package/dist/chunks/providers.mjs +0 -263
  153. package/dist/chunks/quick-actions.mjs +0 -335
  154. package/dist/chunks/quick-provider.mjs +0 -755
  155. package/dist/chunks/quick-setup.mjs +0 -421
  156. package/dist/chunks/remote.mjs +0 -497
  157. package/dist/chunks/research.mjs +0 -1904
  158. package/dist/chunks/rollback.mjs +0 -38
  159. package/dist/chunks/session-manager.mjs +0 -1371
  160. package/dist/chunks/session.mjs +0 -878
  161. package/dist/chunks/sessions.mjs +0 -106
  162. package/dist/chunks/silent-updater.mjs +0 -396
  163. package/dist/chunks/simple-config.mjs +0 -122
  164. package/dist/chunks/skill.mjs +0 -117
  165. package/dist/chunks/skill2.mjs +0 -9052
  166. package/dist/chunks/skills-sync.mjs +0 -1343
  167. package/dist/chunks/skills.mjs +0 -577
  168. package/dist/chunks/slash-commands.mjs +0 -208
  169. package/dist/chunks/smart-guide.mjs +0 -247
  170. package/dist/chunks/snapshot.mjs +0 -58
  171. package/dist/chunks/startup.mjs +0 -487
  172. package/dist/chunks/stats.mjs +0 -191
  173. package/dist/chunks/status.mjs +0 -471
  174. package/dist/chunks/team.mjs +0 -63
  175. package/dist/chunks/thinking.mjs +0 -626
  176. package/dist/chunks/trace.mjs +0 -57
  177. package/dist/chunks/uninstall.mjs +0 -852
  178. package/dist/chunks/update.mjs +0 -174
  179. package/dist/chunks/upgrade-manager.mjs +0 -204
  180. package/dist/chunks/upgrade.mjs +0 -133
  181. package/dist/chunks/version-checker.mjs +0 -891
  182. package/dist/chunks/vim.mjs +0 -903
  183. package/dist/chunks/windows.mjs +0 -14
  184. package/dist/chunks/workflows.mjs +0 -633
  185. package/dist/chunks/wsl.mjs +0 -129
  186. package/dist/chunks/zero-config.mjs +0 -871
  187. package/dist/chunks/zsh.mjs +0 -182
  188. package/dist/cli.d.mts +0 -1
  189. package/dist/cli.d.ts +0 -1
  190. package/dist/cli.mjs +0 -2684
  191. package/dist/i18n/locales/en/agent-teams.json +0 -18
  192. package/dist/i18n/locales/en/agentBrowser.json +0 -80
  193. package/dist/i18n/locales/en/agents.json +0 -135
  194. package/dist/i18n/locales/en/api.json +0 -63
  195. package/dist/i18n/locales/en/ccjk-agents.json +0 -33
  196. package/dist/i18n/locales/en/ccjk-all.json +0 -23
  197. package/dist/i18n/locales/en/ccjk-skills.json +0 -22
  198. package/dist/i18n/locales/en/ccjk.json +0 -276
  199. package/dist/i18n/locales/en/ccr.json +0 -65
  200. package/dist/i18n/locales/en/claude-md.json +0 -73
  201. package/dist/i18n/locales/en/cli.json +0 -148
  202. package/dist/i18n/locales/en/cloud-setup.json +0 -31
  203. package/dist/i18n/locales/en/cloud-sync.json +0 -147
  204. package/dist/i18n/locales/en/cloud.json +0 -40
  205. package/dist/i18n/locales/en/cloudPlugins.json +0 -118
  206. package/dist/i18n/locales/en/codex.json +0 -184
  207. package/dist/i18n/locales/en/cometix.json +0 -29
  208. package/dist/i18n/locales/en/common.json +0 -68
  209. package/dist/i18n/locales/en/config.json +0 -108
  210. package/dist/i18n/locales/en/configuration.json +0 -236
  211. package/dist/i18n/locales/en/context.json +0 -85
  212. package/dist/i18n/locales/en/dashboard.json +0 -78
  213. package/dist/i18n/locales/en/errors.json +0 -26
  214. package/dist/i18n/locales/en/evolution.json +0 -54
  215. package/dist/i18n/locales/en/hooks.json +0 -74
  216. package/dist/i18n/locales/en/hooksSync.json +0 -133
  217. package/dist/i18n/locales/en/installation.json +0 -83
  218. package/dist/i18n/locales/en/interview.json +0 -104
  219. package/dist/i18n/locales/en/language.json +0 -19
  220. package/dist/i18n/locales/en/lsp.json +0 -78
  221. package/dist/i18n/locales/en/marketplace.json +0 -116
  222. package/dist/i18n/locales/en/mcp.json +0 -180
  223. package/dist/i18n/locales/en/memory.json +0 -23
  224. package/dist/i18n/locales/en/menu.json +0 -299
  225. package/dist/i18n/locales/en/multi-config.json +0 -79
  226. package/dist/i18n/locales/en/notification.json +0 -307
  227. package/dist/i18n/locales/en/permissions.json +0 -95
  228. package/dist/i18n/locales/en/persistence.json +0 -127
  229. package/dist/i18n/locales/en/plugins.json +0 -146
  230. package/dist/i18n/locales/en/quick-actions.json +0 -78
  231. package/dist/i18n/locales/en/registry.json +0 -54
  232. package/dist/i18n/locales/en/remote.json +0 -93
  233. package/dist/i18n/locales/en/sandbox.json +0 -44
  234. package/dist/i18n/locales/en/setup.json +0 -44
  235. package/dist/i18n/locales/en/shencha.json +0 -14
  236. package/dist/i18n/locales/en/skills.json +0 -100
  237. package/dist/i18n/locales/en/skillsSync.json +0 -74
  238. package/dist/i18n/locales/en/smartGuide.json +0 -49
  239. package/dist/i18n/locales/en/stats.json +0 -20
  240. package/dist/i18n/locales/en/subagent.json +0 -69
  241. package/dist/i18n/locales/en/superpowers.json +0 -117
  242. package/dist/i18n/locales/en/team.json +0 -7
  243. package/dist/i18n/locales/en/thinking.json +0 -65
  244. package/dist/i18n/locales/en/tools.json +0 -42
  245. package/dist/i18n/locales/en/uninstall.json +0 -56
  246. package/dist/i18n/locales/en/updater.json +0 -29
  247. package/dist/i18n/locales/en/vim.json +0 -169
  248. package/dist/i18n/locales/en/workflow.json +0 -55
  249. package/dist/i18n/locales/en/workspace.json +0 -108
  250. package/dist/i18n/locales/zh-CN/agent-teams.json +0 -18
  251. package/dist/i18n/locales/zh-CN/agentBrowser.json +0 -80
  252. package/dist/i18n/locales/zh-CN/agents.json +0 -135
  253. package/dist/i18n/locales/zh-CN/api.json +0 -63
  254. package/dist/i18n/locales/zh-CN/ccjk-agents.json +0 -33
  255. package/dist/i18n/locales/zh-CN/ccjk-all.json +0 -23
  256. package/dist/i18n/locales/zh-CN/ccjk-skills.json +0 -22
  257. package/dist/i18n/locales/zh-CN/ccjk.json +0 -276
  258. package/dist/i18n/locales/zh-CN/ccr.json +0 -65
  259. package/dist/i18n/locales/zh-CN/claude-md.json +0 -73
  260. package/dist/i18n/locales/zh-CN/cli.json +0 -148
  261. package/dist/i18n/locales/zh-CN/cloud-setup.json +0 -31
  262. package/dist/i18n/locales/zh-CN/cloud-sync.json +0 -147
  263. package/dist/i18n/locales/zh-CN/cloud.json +0 -40
  264. package/dist/i18n/locales/zh-CN/cloudPlugins.json +0 -118
  265. package/dist/i18n/locales/zh-CN/codex.json +0 -184
  266. package/dist/i18n/locales/zh-CN/cometix.json +0 -29
  267. package/dist/i18n/locales/zh-CN/common.json +0 -68
  268. package/dist/i18n/locales/zh-CN/config.json +0 -108
  269. package/dist/i18n/locales/zh-CN/configuration.json +0 -234
  270. package/dist/i18n/locales/zh-CN/context.json +0 -85
  271. package/dist/i18n/locales/zh-CN/dashboard.json +0 -78
  272. package/dist/i18n/locales/zh-CN/errors.json +0 -26
  273. package/dist/i18n/locales/zh-CN/evolution.json +0 -54
  274. package/dist/i18n/locales/zh-CN/hooks.json +0 -74
  275. package/dist/i18n/locales/zh-CN/hooksSync.json +0 -133
  276. package/dist/i18n/locales/zh-CN/installation.json +0 -83
  277. package/dist/i18n/locales/zh-CN/interview.json +0 -104
  278. package/dist/i18n/locales/zh-CN/language.json +0 -19
  279. package/dist/i18n/locales/zh-CN/lsp.json +0 -78
  280. package/dist/i18n/locales/zh-CN/marketplace.json +0 -116
  281. package/dist/i18n/locales/zh-CN/mcp.json +0 -180
  282. package/dist/i18n/locales/zh-CN/memory.json +0 -23
  283. package/dist/i18n/locales/zh-CN/menu.json +0 -299
  284. package/dist/i18n/locales/zh-CN/multi-config.json +0 -79
  285. package/dist/i18n/locales/zh-CN/notification.json +0 -307
  286. package/dist/i18n/locales/zh-CN/permissions.json +0 -95
  287. package/dist/i18n/locales/zh-CN/persistence.json +0 -127
  288. package/dist/i18n/locales/zh-CN/plugins.json +0 -146
  289. package/dist/i18n/locales/zh-CN/quick-actions.json +0 -78
  290. package/dist/i18n/locales/zh-CN/registry.json +0 -54
  291. package/dist/i18n/locales/zh-CN/remote.json +0 -93
  292. package/dist/i18n/locales/zh-CN/sandbox.json +0 -44
  293. package/dist/i18n/locales/zh-CN/setup.json +0 -44
  294. package/dist/i18n/locales/zh-CN/shencha.json +0 -14
  295. package/dist/i18n/locales/zh-CN/skills.json +0 -100
  296. package/dist/i18n/locales/zh-CN/skillsSync.json +0 -74
  297. package/dist/i18n/locales/zh-CN/smartGuide.json +0 -49
  298. package/dist/i18n/locales/zh-CN/stats.json +0 -20
  299. package/dist/i18n/locales/zh-CN/subagent.json +0 -69
  300. package/dist/i18n/locales/zh-CN/superpowers.json +0 -117
  301. package/dist/i18n/locales/zh-CN/team.json +0 -7
  302. package/dist/i18n/locales/zh-CN/thinking.json +0 -65
  303. package/dist/i18n/locales/zh-CN/tools.json +0 -42
  304. package/dist/i18n/locales/zh-CN/uninstall.json +0 -56
  305. package/dist/i18n/locales/zh-CN/updater.json +0 -29
  306. package/dist/i18n/locales/zh-CN/vim.json +0 -169
  307. package/dist/i18n/locales/zh-CN/workflow.json +0 -55
  308. package/dist/i18n/locales/zh-CN/workspace.json +0 -108
  309. package/dist/index.d.mts +0 -5658
  310. package/dist/index.d.ts +0 -5658
  311. package/dist/index.mjs +0 -3732
  312. package/dist/shared/ccjk.5bEolFrk.mjs +0 -254
  313. package/dist/shared/ccjk.8oaxX4iR.mjs +0 -90
  314. package/dist/shared/ccjk.B2U7DsPy.mjs +0 -31
  315. package/dist/shared/ccjk.B2f-cwUP.mjs +0 -468
  316. package/dist/shared/ccjk.BAGoDD49.mjs +0 -36
  317. package/dist/shared/ccjk.BBtCGd_g.mjs +0 -899
  318. package/dist/shared/ccjk.BFQ7yr5S.mjs +0 -16
  319. package/dist/shared/ccjk.BLsIiTqO.mjs +0 -449
  320. package/dist/shared/ccjk.BXv8aYs1.mjs +0 -170
  321. package/dist/shared/ccjk.BnsY5WxD.mjs +0 -171
  322. package/dist/shared/ccjk.BoApaI4j.mjs +0 -28
  323. package/dist/shared/ccjk.Bq8TqZG_.mjs +0 -189
  324. package/dist/shared/ccjk.BtrioX1Z.mjs +0 -25
  325. package/dist/shared/ccjk.Bx_rmYfN.mjs +0 -69
  326. package/dist/shared/ccjk.BzPbSEP2.mjs +0 -115
  327. package/dist/shared/ccjk.C0WLUnFV.mjs +0 -293
  328. package/dist/shared/ccjk.C1hANZTu.mjs +0 -19
  329. package/dist/shared/ccjk.C2jHOZVP.mjs +0 -52
  330. package/dist/shared/ccjk.CNhnT6uQ.mjs +0 -636
  331. package/dist/shared/ccjk.COweQ1RR.mjs +0 -5
  332. package/dist/shared/ccjk.CfKKcvWy.mjs +0 -126
  333. package/dist/shared/ccjk.Cjgrln_h.mjs +0 -297
  334. package/dist/shared/ccjk.CoCHVXl3.mjs +0 -3951
  335. package/dist/shared/ccjk.CwGZSTAK.mjs +0 -319
  336. package/dist/shared/ccjk.CxpGa6MC.mjs +0 -2724
  337. package/dist/shared/ccjk.D-magaEx.mjs +0 -763
  338. package/dist/shared/ccjk.D0g2ABGg.mjs +0 -171
  339. package/dist/shared/ccjk.D6ycHbak.mjs +0 -270
  340. package/dist/shared/ccjk.D75wivnp.mjs +0 -142
  341. package/dist/shared/ccjk.DDL-4C-k.mjs +0 -100
  342. package/dist/shared/ccjk.DFRPtmK_.mjs +0 -75
  343. package/dist/shared/ccjk.DMV3x5Sd.mjs +0 -299
  344. package/dist/shared/ccjk.DZ2LLOa-.mjs +0 -2195
  345. package/dist/shared/ccjk.DbigonEQ.mjs +0 -698
  346. package/dist/shared/ccjk.DcMvE7lf.mjs +0 -618
  347. package/dist/shared/ccjk.DeWpAShp.mjs +0 -1828
  348. package/dist/shared/ccjk.DhJ1kyDR.mjs +0 -30
  349. package/dist/shared/ccjk.DlTXS9rP.mjs +0 -224
  350. package/dist/shared/ccjk.DopKzo3z.mjs +0 -305
  351. package/dist/shared/ccjk.DsZsc4LR.mjs +0 -1280
  352. package/dist/shared/ccjk.DuzJZlgj.mjs +0 -418
  353. package/dist/shared/ccjk.Dxgd2vjc.mjs +0 -444
  354. package/dist/shared/ccjk.J8YiPsOw.mjs +0 -259
  355. package/dist/shared/ccjk.KfSWcGlE.mjs +0 -38
  356. package/dist/shared/ccjk.L7yC58_i.mjs +0 -225
  357. package/dist/shared/ccjk.MwtjAULc.mjs +0 -1447
  358. package/dist/shared/ccjk.OJKHVSOb.mjs +0 -2005
  359. package/dist/shared/ccjk.OTnevPNE.mjs +0 -225
  360. package/dist/shared/ccjk.RyizuzOI.mjs +0 -21
  361. package/dist/shared/ccjk.T_cX87dY.mjs +0 -15
  362. package/dist/shared/ccjk.bQ7Dh1g4.mjs +0 -249
  363. package/dist/shared/ccjk.gDEDGD_t.mjs +0 -38
  364. package/dist/shared/ccjk.hoqrwWdN.mjs +0 -333
  365. package/dist/shared/ccjk.i_vn-9C3.mjs +0 -317
  366. package/dist/shared/ccjk.lG3ccFjm.mjs +0 -885
  367. package/dist/shared/ccjk.wLJHO0Af.mjs +0 -244
  368. package/dist/shared/ccjk.y-a_1vK4.mjs +0 -5127
  369. package/dist/templates/agents/README.md +0 -78
  370. package/dist/templates/agents/fullstack-developer.json +0 -70
  371. package/dist/templates/agents/go-expert.json +0 -69
  372. package/dist/templates/agents/index.json +0 -64
  373. package/dist/templates/agents/python-expert.json +0 -69
  374. package/dist/templates/agents/react-specialist.json +0 -69
  375. package/dist/templates/agents/testing-automation-expert.json +0 -70
  376. package/dist/templates/agents/typescript-architect.json +0 -69
  377. package/dist/templates/claude-code/common/settings.json +0 -109
  378. package/dist/templates/common/error-prevention.md +0 -267
  379. package/dist/templates/common/karpathy-baseline.md +0 -83
  380. package/dist/templates/common/output-styles/zh-CN/carmack-mode.md +0 -381
  381. package/dist/templates/common/output-styles/zh-CN/codex-rigor-mode.md +0 -114
  382. package/dist/templates/common/output-styles/zh-CN/dhh-mode.md +0 -265
  383. package/dist/templates/common/output-styles/zh-CN/evan-you-mode.md +0 -539
  384. package/dist/templates/common/output-styles/zh-CN/jobs-mode.md +0 -369
  385. package/dist/templates/common/output-styles/zh-CN/linus-mode.md +0 -135
  386. package/dist/templates/common/output-styles/zh-CN/uncle-bob-mode.md +0 -221
  387. package/dist/templates/common/workflow/continuousDelivery/en/continuous-delivery.md +0 -628
  388. package/dist/templates/common/workflow/continuousDelivery/zh-CN/continuous-delivery.md +0 -628
  389. package/dist/templates/common/workflow/essential/en/agents/ccjk-config-agent.md +0 -187
  390. package/dist/templates/common/workflow/essential/en/agents/ccjk-mcp-agent.md +0 -191
  391. package/dist/templates/common/workflow/essential/en/agents/ccjk-skill-agent.md +0 -249
  392. package/dist/templates/common/workflow/essential/en/agents/ccjk-workflow-agent.md +0 -277
  393. package/dist/templates/common/workflow/essential/en/agents/get-current-datetime.md +0 -29
  394. package/dist/templates/common/workflow/essential/en/agents/init-architect.md +0 -115
  395. package/dist/templates/common/workflow/essential/en/agents/ui-ux-designer.md +0 -91
  396. package/dist/templates/common/workflow/essential/en/feat.md +0 -92
  397. package/dist/templates/common/workflow/essential/en/goal.md +0 -147
  398. package/dist/templates/common/workflow/essential/en/init-project.md +0 -53
  399. package/dist/templates/common/workflow/essential/zh-CN/agents/get-current-datetime.md +0 -29
  400. package/dist/templates/common/workflow/essential/zh-CN/agents/init-architect.md +0 -115
  401. package/dist/templates/common/workflow/essential/zh-CN/agents/ui-ux-designer.md +0 -91
  402. package/dist/templates/common/workflow/essential/zh-CN/feat.md +0 -315
  403. package/dist/templates/common/workflow/essential/zh-CN/goal.md +0 -146
  404. package/dist/templates/common/workflow/essential/zh-CN/init-project.md +0 -53
  405. package/dist/templates/common/workflow/git/en/git-cleanBranches.md +0 -102
  406. package/dist/templates/common/workflow/git/en/git-commit.md +0 -205
  407. package/dist/templates/common/workflow/git/en/git-rollback.md +0 -90
  408. package/dist/templates/common/workflow/git/en/git-worktree.md +0 -276
  409. package/dist/templates/common/workflow/git/zh-CN/git-cleanBranches.md +0 -102
  410. package/dist/templates/common/workflow/git/zh-CN/git-commit.md +0 -205
  411. package/dist/templates/common/workflow/git/zh-CN/git-rollback.md +0 -90
  412. package/dist/templates/common/workflow/git/zh-CN/git-worktree.md +0 -276
  413. package/dist/templates/common/workflow/interview/en/interview.md +0 -67
  414. package/dist/templates/common/workflow/interview/zh-CN/interview.md +0 -67
  415. package/dist/templates/common/workflow/linearMethod/en/linear-method.md +0 -651
  416. package/dist/templates/common/workflow/linearMethod/zh-CN/linear-method.md +0 -752
  417. package/dist/templates/common/workflow/refactoringMaster/en/refactoring-master.md +0 -516
  418. package/dist/templates/common/workflow/refactoringMaster/zh-CN/refactoring-master.md +0 -812
  419. package/dist/templates/common/workflow/sixStep/en/workflow.md +0 -83
  420. package/dist/templates/common/workflow/sixStep/zh-CN/workflow.md +0 -359
  421. package/dist/templates/common/workflow/specFirstTDD/en/spec-first-tdd.md +0 -364
  422. package/dist/templates/common/workflow/specFirstTDD/zh-CN/spec-first-tdd.md +0 -366
  423. package/dist/templates/hooks/README.md +0 -212
  424. package/dist/templates/hooks/git-workflow-hooks.md +0 -551
  425. package/dist/templates/hooks/post-test/coverage.json +0 -21
  426. package/dist/templates/hooks/post-test/summary.json +0 -21
  427. package/dist/templates/hooks/post-test-coverage.md +0 -434
  428. package/dist/templates/hooks/pre-commit/eslint.json +0 -22
  429. package/dist/templates/hooks/pre-commit/prettier.json +0 -22
  430. package/dist/templates/hooks/pre-commit-black.md +0 -274
  431. package/dist/templates/hooks/pre-commit-eslint.md +0 -153
  432. package/dist/templates/hooks/pre-commit-gofmt.md +0 -284
  433. package/dist/templates/hooks/pre-commit-prettier.md +0 -212
  434. package/dist/templates/hooks/pre-commit-type-check.md +0 -377
  435. package/dist/templates/skills/ccjk-init.md +0 -154
  436. package/dist/templates/skills/ccjk-mcp-setup.md +0 -205
  437. package/dist/templates/skills/ccjk-troubleshoot.md +0 -228
  438. package/dist/templates/skills/django-patterns.md +0 -1016
  439. package/dist/templates/skills/git-workflow.md +0 -748
  440. package/dist/templates/skills/go-idioms.md +0 -963
  441. package/dist/templates/skills/index.json +0 -132
  442. package/dist/templates/skills/nextjs-optimization.md +0 -694
  443. package/dist/templates/skills/python-pep8.md +0 -852
  444. package/dist/templates/skills/react-patterns.md +0 -686
  445. package/dist/templates/skills/rust-patterns.md +0 -1057
  446. package/dist/templates/skills/security-best-practices.md +0 -1413
  447. package/dist/templates/skills/testing-best-practices.md +0 -1315
  448. package/dist/templates/skills/ts-best-practices.md +0 -354
  449. package/templates/agents/README.md +0 -78
  450. package/templates/agents/fullstack-developer.json +0 -70
  451. package/templates/agents/go-expert.json +0 -69
  452. package/templates/agents/index.json +0 -64
  453. package/templates/agents/python-expert.json +0 -69
  454. package/templates/agents/react-specialist.json +0 -69
  455. package/templates/agents/testing-automation-expert.json +0 -70
  456. package/templates/agents/typescript-architect.json +0 -69
  457. package/templates/claude-code/common/settings.json +0 -109
  458. package/templates/common/error-prevention.md +0 -267
  459. package/templates/common/karpathy-baseline.md +0 -83
  460. package/templates/common/output-styles/zh-CN/carmack-mode.md +0 -381
  461. package/templates/common/output-styles/zh-CN/codex-rigor-mode.md +0 -114
  462. package/templates/common/output-styles/zh-CN/dhh-mode.md +0 -265
  463. package/templates/common/output-styles/zh-CN/evan-you-mode.md +0 -539
  464. package/templates/common/output-styles/zh-CN/jobs-mode.md +0 -369
  465. package/templates/common/output-styles/zh-CN/linus-mode.md +0 -135
  466. package/templates/common/output-styles/zh-CN/uncle-bob-mode.md +0 -221
  467. package/templates/common/workflow/continuousDelivery/en/continuous-delivery.md +0 -628
  468. package/templates/common/workflow/continuousDelivery/zh-CN/continuous-delivery.md +0 -628
  469. package/templates/common/workflow/essential/en/agents/ccjk-config-agent.md +0 -187
  470. package/templates/common/workflow/essential/en/agents/ccjk-mcp-agent.md +0 -191
  471. package/templates/common/workflow/essential/en/agents/ccjk-skill-agent.md +0 -249
  472. package/templates/common/workflow/essential/en/agents/ccjk-workflow-agent.md +0 -277
  473. package/templates/common/workflow/essential/en/agents/get-current-datetime.md +0 -29
  474. package/templates/common/workflow/essential/en/agents/init-architect.md +0 -115
  475. package/templates/common/workflow/essential/en/agents/ui-ux-designer.md +0 -91
  476. package/templates/common/workflow/essential/en/feat.md +0 -92
  477. package/templates/common/workflow/essential/en/goal.md +0 -147
  478. package/templates/common/workflow/essential/en/init-project.md +0 -53
  479. package/templates/common/workflow/essential/zh-CN/agents/get-current-datetime.md +0 -29
  480. package/templates/common/workflow/essential/zh-CN/agents/init-architect.md +0 -115
  481. package/templates/common/workflow/essential/zh-CN/agents/ui-ux-designer.md +0 -91
  482. package/templates/common/workflow/essential/zh-CN/feat.md +0 -315
  483. package/templates/common/workflow/essential/zh-CN/goal.md +0 -146
  484. package/templates/common/workflow/essential/zh-CN/init-project.md +0 -53
  485. package/templates/common/workflow/git/en/git-cleanBranches.md +0 -102
  486. package/templates/common/workflow/git/en/git-commit.md +0 -205
  487. package/templates/common/workflow/git/en/git-rollback.md +0 -90
  488. package/templates/common/workflow/git/en/git-worktree.md +0 -276
  489. package/templates/common/workflow/git/zh-CN/git-cleanBranches.md +0 -102
  490. package/templates/common/workflow/git/zh-CN/git-commit.md +0 -205
  491. package/templates/common/workflow/git/zh-CN/git-rollback.md +0 -90
  492. package/templates/common/workflow/git/zh-CN/git-worktree.md +0 -276
  493. package/templates/common/workflow/interview/en/interview.md +0 -67
  494. package/templates/common/workflow/interview/zh-CN/interview.md +0 -67
  495. package/templates/common/workflow/linearMethod/en/linear-method.md +0 -651
  496. package/templates/common/workflow/linearMethod/zh-CN/linear-method.md +0 -752
  497. package/templates/common/workflow/refactoringMaster/en/refactoring-master.md +0 -516
  498. package/templates/common/workflow/refactoringMaster/zh-CN/refactoring-master.md +0 -812
  499. package/templates/common/workflow/sixStep/en/workflow.md +0 -83
  500. package/templates/common/workflow/sixStep/zh-CN/workflow.md +0 -359
  501. package/templates/common/workflow/specFirstTDD/en/spec-first-tdd.md +0 -364
  502. package/templates/common/workflow/specFirstTDD/zh-CN/spec-first-tdd.md +0 -366
  503. package/templates/hooks/README.md +0 -212
  504. package/templates/hooks/git-workflow-hooks.md +0 -551
  505. package/templates/hooks/post-test/coverage.json +0 -21
  506. package/templates/hooks/post-test/summary.json +0 -21
  507. package/templates/hooks/post-test-coverage.md +0 -434
  508. package/templates/hooks/pre-commit/eslint.json +0 -22
  509. package/templates/hooks/pre-commit/prettier.json +0 -22
  510. package/templates/hooks/pre-commit-black.md +0 -274
  511. package/templates/hooks/pre-commit-eslint.md +0 -153
  512. package/templates/hooks/pre-commit-gofmt.md +0 -284
  513. package/templates/hooks/pre-commit-prettier.md +0 -212
  514. package/templates/hooks/pre-commit-type-check.md +0 -377
  515. package/templates/skills/basic.hbs +0 -72
  516. package/templates/skills/ccjk-init.md +0 -154
  517. package/templates/skills/ccjk-mcp-setup.md +0 -205
  518. package/templates/skills/ccjk-troubleshoot.md +0 -228
  519. package/templates/skills/code-refactor.hbs +0 -133
  520. package/templates/skills/code-review.hbs +0 -141
  521. package/templates/skills/django-patterns.md +0 -1016
  522. package/templates/skills/git-workflow.md +0 -748
  523. package/templates/skills/go-idioms.md +0 -963
  524. package/templates/skills/index.json +0 -132
  525. package/templates/skills/nextjs-optimization.md +0 -694
  526. package/templates/skills/python-pep8.md +0 -852
  527. package/templates/skills/react-patterns.md +0 -686
  528. package/templates/skills/rust-patterns.md +0 -1057
  529. package/templates/skills/security-best-practices.md +0 -1413
  530. package/templates/skills/testing-best-practices.md +0 -1315
  531. package/templates/skills/ts-best-practices.md +0 -354
  532. 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
- - [ ] 识别并修复不稳定的测试