ccjk 14.1.10 → 14.2.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 (119) hide show
  1. package/dist/chunks/agent-teams.mjs +1 -1
  2. package/dist/chunks/api-cli.mjs +1 -1
  3. package/dist/chunks/api-config-selector.mjs +3 -3
  4. package/dist/chunks/ccjk-all.mjs +1 -1
  5. package/dist/chunks/ccjk-mcp.mjs +1 -1
  6. package/dist/chunks/ccjk-setup.mjs +1 -1
  7. package/dist/chunks/ccr.mjs +8 -8
  8. package/dist/chunks/check-updates.mjs +1 -1
  9. package/dist/chunks/claude-code-incremental-manager.mjs +3 -3
  10. package/dist/chunks/claude-config.mjs +1 -1
  11. package/dist/chunks/codex-config-switch.mjs +1 -1
  12. package/dist/chunks/codex-provider-manager.mjs +1 -1
  13. package/dist/chunks/config-switch.mjs +1 -1
  14. package/dist/chunks/config.mjs +19 -3
  15. package/dist/chunks/config2.mjs +1 -1
  16. package/dist/chunks/config3.mjs +1 -1
  17. package/dist/chunks/doctor.mjs +175 -6
  18. package/dist/chunks/features.mjs +3 -3
  19. package/dist/chunks/index10.mjs +19 -5
  20. package/dist/chunks/init.mjs +5 -5
  21. package/dist/chunks/mcp-cli.mjs +3 -3
  22. package/dist/chunks/mcp.mjs +3 -3
  23. package/dist/chunks/package.mjs +1 -1
  24. package/dist/chunks/quick-provider.mjs +1 -1
  25. package/dist/chunks/quick-setup.mjs +5 -5
  26. package/dist/chunks/simple-config.mjs +1 -1
  27. package/dist/chunks/smart-guide.mjs +1 -1
  28. package/dist/chunks/update.mjs +6 -6
  29. package/dist/chunks/zero-config.mjs +7 -4
  30. package/dist/cli.mjs +0 -0
  31. package/dist/index.d.mts +3 -0
  32. package/dist/index.d.ts +3 -0
  33. package/dist/index.mjs +1 -1
  34. package/dist/shared/{ccjk.BJ3Zpjo5.mjs → ccjk.BCzOWT1L.mjs} +3 -2
  35. package/dist/shared/{ccjk.B8oqkakg.mjs → ccjk.BLsIiTqO.mjs} +1 -1
  36. package/dist/shared/{ccjk.Hwoicrh8.mjs → ccjk.BXv8aYs1.mjs} +1 -1
  37. package/dist/shared/{ccjk.B9OuS4xZ.mjs → ccjk.CfKJnpbB.mjs} +1 -1
  38. package/dist/shared/{ccjk.BzxpiEPF.mjs → ccjk.Cgv_cFVX.mjs} +2 -2
  39. package/dist/shared/{ccjk.Di1IYU3u.mjs → ccjk.DDL-4C-k.mjs} +47 -10
  40. package/dist/shared/{ccjk.BEiR3L4C.mjs → ccjk.DOw7Fawt.mjs} +3 -3
  41. package/dist/shared/{ccjk.tI_s2uSh.mjs → ccjk.f3TBLJSt.mjs} +1 -1
  42. package/dist/templates/agents/README.md +78 -0
  43. package/dist/templates/common/error-prevention.md +267 -0
  44. package/dist/templates/common/karpathy-baseline.md +83 -0
  45. package/dist/templates/common/output-styles/zh-CN/carmack-mode.md +381 -0
  46. package/dist/templates/common/output-styles/zh-CN/dhh-mode.md +265 -0
  47. package/dist/templates/common/output-styles/zh-CN/evan-you-mode.md +539 -0
  48. package/dist/templates/common/output-styles/zh-CN/jobs-mode.md +369 -0
  49. package/dist/templates/common/output-styles/zh-CN/linus-mode.md +135 -0
  50. package/dist/templates/common/output-styles/zh-CN/uncle-bob-mode.md +221 -0
  51. package/dist/templates/common/workflow/continuousDelivery/en/continuous-delivery.md +628 -0
  52. package/dist/templates/common/workflow/continuousDelivery/zh-CN/continuous-delivery.md +628 -0
  53. package/dist/templates/common/workflow/essential/en/agents/ccjk-config-agent.md +187 -0
  54. package/dist/templates/common/workflow/essential/en/agents/ccjk-mcp-agent.md +191 -0
  55. package/dist/templates/common/workflow/essential/en/agents/ccjk-skill-agent.md +249 -0
  56. package/dist/templates/common/workflow/essential/en/agents/ccjk-workflow-agent.md +277 -0
  57. package/dist/templates/common/workflow/essential/en/agents/get-current-datetime.md +29 -0
  58. package/dist/templates/common/workflow/essential/en/agents/init-architect.md +115 -0
  59. package/dist/templates/common/workflow/essential/en/agents/ui-ux-designer.md +91 -0
  60. package/dist/templates/common/workflow/essential/en/feat.md +92 -0
  61. package/dist/templates/common/workflow/essential/en/goal.md +147 -0
  62. package/dist/templates/common/workflow/essential/en/init-project.md +53 -0
  63. package/dist/templates/common/workflow/essential/zh-CN/agents/get-current-datetime.md +29 -0
  64. package/dist/templates/common/workflow/essential/zh-CN/agents/init-architect.md +115 -0
  65. package/dist/templates/common/workflow/essential/zh-CN/agents/ui-ux-designer.md +91 -0
  66. package/dist/templates/common/workflow/essential/zh-CN/feat.md +315 -0
  67. package/dist/templates/common/workflow/essential/zh-CN/goal.md +146 -0
  68. package/dist/templates/common/workflow/essential/zh-CN/init-project.md +53 -0
  69. package/dist/templates/common/workflow/git/en/git-cleanBranches.md +102 -0
  70. package/dist/templates/common/workflow/git/en/git-commit.md +205 -0
  71. package/dist/templates/common/workflow/git/en/git-rollback.md +90 -0
  72. package/dist/templates/common/workflow/git/en/git-worktree.md +276 -0
  73. package/dist/templates/common/workflow/git/zh-CN/git-cleanBranches.md +102 -0
  74. package/dist/templates/common/workflow/git/zh-CN/git-commit.md +205 -0
  75. package/dist/templates/common/workflow/git/zh-CN/git-rollback.md +90 -0
  76. package/dist/templates/common/workflow/git/zh-CN/git-worktree.md +276 -0
  77. package/dist/templates/common/workflow/interview/en/interview.md +67 -0
  78. package/dist/templates/common/workflow/interview/zh-CN/interview.md +67 -0
  79. package/dist/templates/common/workflow/linearMethod/en/linear-method.md +651 -0
  80. package/dist/templates/common/workflow/linearMethod/zh-CN/linear-method.md +752 -0
  81. package/dist/templates/common/workflow/refactoringMaster/en/refactoring-master.md +516 -0
  82. package/dist/templates/common/workflow/refactoringMaster/zh-CN/refactoring-master.md +812 -0
  83. package/dist/templates/common/workflow/sixStep/en/workflow.md +83 -0
  84. package/dist/templates/common/workflow/sixStep/zh-CN/workflow.md +359 -0
  85. package/dist/templates/common/workflow/specFirstTDD/en/spec-first-tdd.md +364 -0
  86. package/dist/templates/common/workflow/specFirstTDD/zh-CN/spec-first-tdd.md +366 -0
  87. package/dist/templates/hooks/README.md +212 -0
  88. package/dist/templates/hooks/git-workflow-hooks.md +551 -0
  89. package/dist/templates/hooks/post-test-coverage.md +434 -0
  90. package/dist/templates/hooks/pre-commit-black.md +274 -0
  91. package/dist/templates/hooks/pre-commit-eslint.md +153 -0
  92. package/dist/templates/hooks/pre-commit-gofmt.md +284 -0
  93. package/dist/templates/hooks/pre-commit-prettier.md +212 -0
  94. package/dist/templates/hooks/pre-commit-type-check.md +377 -0
  95. package/dist/templates/skills/ccjk-init.md +154 -0
  96. package/dist/templates/skills/ccjk-mcp-setup.md +205 -0
  97. package/dist/templates/skills/ccjk-troubleshoot.md +228 -0
  98. package/dist/templates/skills/django-patterns.md +1016 -0
  99. package/dist/templates/skills/git-workflow.md +748 -0
  100. package/dist/templates/skills/go-idioms.md +963 -0
  101. package/dist/templates/skills/nextjs-optimization.md +694 -0
  102. package/dist/templates/skills/python-pep8.md +852 -0
  103. package/dist/templates/skills/react-patterns.md +686 -0
  104. package/dist/templates/skills/rust-patterns.md +1057 -0
  105. package/dist/templates/skills/security-best-practices.md +1413 -0
  106. package/dist/templates/skills/testing-best-practices.md +1315 -0
  107. package/dist/templates/skills/ts-best-practices.md +354 -0
  108. package/package.json +40 -43
  109. package/templates/common/karpathy-baseline.md +83 -0
  110. package/templates/common/output-styles/zh-CN/carmack-mode.md +14 -0
  111. package/templates/common/output-styles/zh-CN/dhh-mode.md +14 -0
  112. package/templates/common/output-styles/zh-CN/evan-you-mode.md +14 -0
  113. package/templates/common/output-styles/zh-CN/jobs-mode.md +14 -0
  114. package/templates/common/output-styles/zh-CN/linus-mode.md +14 -0
  115. package/templates/common/output-styles/zh-CN/uncle-bob-mode.md +14 -0
  116. package/templates/common/workflow/linearMethod/zh-CN/linear-method.md +2 -0
  117. package/templates/common/workflow/refactoringMaster/zh-CN/refactoring-master.md +2 -0
  118. package/templates/common/workflow/sixStep/zh-CN/workflow.md +2 -0
  119. package/templates/common/workflow/specFirstTDD/zh-CN/spec-first-tdd.md +2 -0
@@ -0,0 +1,1315 @@
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
+ - [ ] 识别并修复不稳定的测试