測試步驟 - Clean Architecture in TypeScript

1export async function whenVisitHome() {
2  // ...
3}

1describe("GET /", () => {
2  it("can access home page", async () => {
3    const res = await whenVisitHome()
4    await thenPageContains("Hello World")
5  })
6})

 1Create `test/steps/cart.ts` to create BDD-style steps for testing the cart functionality.
 2
 3```typescript
 4export async function givenCartItems(cartId, items: { ... }[]): void {
 5  // Resolve mock repository use tsyringe
 6  // Save cart items to the mock repository
 7}
 8```
 9
10When testing cart API, you should use the `givenCartItems` step to setup the initial state of the cart.
11
12```typescript
13import { givenCartItems } from './steps/cart';
14
15describe('Cart API', () => {
16	it('should return empty cart for new cart ID', async () => {
17	  // Cart setup step
18	  // Http step
19	  // Assert step
20    });
21})
22```
23
24You do SHOULD NOT change any production code, use steps and mocks to test the cart API.

 1it('should return cart with items when items are added', async () => {
 2    // Given
 3    const cartId = 'test-cart-with-items';
 4    await givenCartItems(cartId, [
 5      { name: 'Apple', unitPrice: 100, quantity: 2 },
 6      { name: 'Banana', unitPrice: 50, quantity: 3 }
 7    ]);
 8
 9    // When
10    const response = await whenGetCart(cartId);
11
12    // Then
13    await thenCartShouldContain(response, [
14      { name: 'Apple', price: 100, quantity: 2 },
15      { name: 'Banana', price: 50, quantity: 3 }
16    ]);
17  });

 1Create `test/steps/chat.ts` to create BDD-style steps for testing the cart functionality.
 2
 3```typescript
 4export async function givenChatMessage(chatId, messages: { ... }[]): void {
 5  // Resolve mock repository use tsyringe
 6  // Save messages to the mock repository
 7}
 8```
 9
10When testing chat API, you should use the `givenChatMessage` step to setup the initial state of the chat.
11
12```typescript
13import { givenChatMessage } from './steps/chat';
14
15describe('Chat API', () => {
16	it('should return empty messages for new chat ID', async () => {
17	  // Chat setup step
18	  // Http step
19	  // Assert step
20    });
21})
22```
23
24You do SHOULD NOT change any production code, use steps and mocks to test the chat API. No need to test POST requests, only GET requests.

 1it('should return conversation history in correct order', async () => {
 2    const chatId = 'test-chat-conversation';
 3
 4    // Given
 5    await givenChatMessage(chatId, [
 6      { role: 'user', content: 'First message' },
 7      { role: 'assistant', content: 'First response' },
 8      { role: 'user', content: 'Second message' },
 9      { role: 'assistant', content: 'Second response' }
10    ]);
11
12    // When
13    const response = await whenGetChatMessages(chatId);
14
15    // Then
16    await thenChatShouldContain(response, [
17      { role: 'user', content: 'First message' },
18      { role: 'assistant', content: 'First response' },
19      { role: 'user', content: 'Second message' },
20      { role: 'assistant', content: 'Second response' }
21    ]);
22  });