測試與除錯

Verdent for VS Code 透過多輪生成－測試－修復循環、錯誤分析以及自動化的測試覆蓋率改善，協助你撰寫完整的測試並除錯問題。生成符合你專案測試框架與風格的單元測試、整合測試與端對端測試。

你將學到

• 生成涵蓋邊界情況與預期行為的單元測試
• 使用所有主流測試框架（Jest、Pytest、JUnit 等）
• 建立驗證多元件工作流程的整合測試
• 透過找出並測試未覆蓋的程式碼路徑來改善測試覆蓋率
• 透過錯誤訊息分析與執行追蹤來除錯問題
• 從堆疊追蹤、錯誤日誌與非預期行為診斷錯誤

先決條件

在使用 Verdent 進行測試與除錯之前：

• 已安裝 Verdent 擴充功能的 Visual Studio Code
• 已在 VS Code 中開啟程式碼庫或專案工作區
• 有效的 Verdent 方案且有可用點數
• 專案中已設定測試框架（用於測試生成時為選用）

撰寫單元測試

Verdent 生成符合你專案測試框架與風格的單元測試。它會分析現有測試以理解你的模式，接著生成具有適當設定、斷言與模擬的測試。

範例：

Write unit tests for the calculateDiscount function

Verdent 會：

• 檢視 calculateDiscount 函式的實作
• 識別輸入參數與回傳值
• 分析現有測試以符合你的慣例（測試結構、斷言風格、命名模式）
• 生成涵蓋以下情況的測試：
  • 正常路徑：有效輸入與預期輸出
  • 邊界情況：邊界值、零、負數、最大值
  • 無效輸入：null、undefined、錯誤型別
  • 預期行為：商業邏輯驗證

生成的測試結構：

Verdent 依照你專案的模式建立測試：

• 測試套件組織：describe 區塊、測試類別或模組結構
• 設定與清理：符合你現有測試的 before/after hook
• 斷言：使用你專案的斷言函式庫（expect、assert、should 等）
• 模擬：符合你的模擬模式（jest.mock、sinon、unittest.mock）
• 命名慣例：依照你既有風格的測試名稱

多輪生成－測試－修復循環：

為了進行完整的測試，Verdent 採用多輪循環：

1. 生成：建立初始測試套件
2. 執行：執行測試以驗證其運作
3. 修復：修正失敗的測試或改善覆蓋率
4. 迭代：重複進行直到測試通過且覆蓋率足夠

這能確保測試不僅被撰寫出來，而且確實能與你的程式碼庫正確協作。

支援的測試框架

Verdent 支援跨不同程式語言與技術堆疊的所有主流測試框架，無需額外設定。

test('sum returns correct result', () => {
  expect(sum(2, 3)).toBe(5);
});

const assert = require('assert');

describe('sum', () => {
  it('returns correct result', () => {
    assert.strictEqual(sum(2, 3), 5);
  });
});

import { describe, it, expect } from 'vitest';

it('sum returns correct result', () => {
  expect(sum(2, 3)).toBe(5);
});

describe('sum', () => {
  it('returns correct result', () => {
    expect(sum(2, 3)).toEqual(5);
  });
});

Verdent 從你的專案設定與現有測試中辨識你的測試框架，自動生成符合你設定的測試。

生成整合測試

Verdent 生成整合測試，驗證多個元件、服務或模組如何協同運作。它建立模擬真實工作流程的測試，包括 API 互動、資料庫操作、驗證流程與多步驟使用者旅程。

範例：

Write integration tests for the user registration flow

Verdent 生成驗證完整流程的測試：

1. 表單提交：使用者以有效資料提交註冊表單
2. 驗證：後端驗證電子郵件格式、密碼強度、資料完整性
3. 資料庫插入：在資料庫中建立使用者記錄
4. 郵件傳送：傳送確認電子郵件（模擬或實際）
5. 成功登入：新使用者可立即以憑證登入

整合測試結構：

Verdent 建立的整合測試包含：

• 測試設定：資料庫填充、服務初始化、測試資料建立
• 工作流程模擬：依序執行多步驟操作
• 狀態驗證：檢查資料庫狀態、API 回應、副作用
• 模擬外部服務：郵件服務、付款 API、第三方整合
• 測試清理：清理測試資料、資料庫回滾、服務關閉

範例測試情境：

Write integration tests for the checkout and payment process

Verdent 測試：

• 將商品加入購物車
• 套用折扣碼
• 計算含稅與運費的總額
• 處理付款（以模擬付款閘道）
• 在資料庫中建立訂單記錄
• 傳送確認電子郵件
• 更新庫存

測試隔離：

Verdent 確保整合測試適當隔離：

• 每個測試都以乾淨的資料庫狀態開始
• 模擬外部服務呼叫以防止副作用
• 測試可以任意順序執行而無相依性
• 即使測試失敗也會進行清理

改善測試覆蓋率

Verdent 分析你的程式碼庫，找出未測試的函式、分支與邊界情況，接著生成測試以改善覆蓋率。它檢視你現有的測試套件，找出程式碼路徑未被執行的缺口。

範例：

Analyze test coverage and write tests for uncovered code paths in the payment module

Verdent 會：

1. 分析現有測試：檢視目前測試了哪些內容
2. 找出覆蓋率缺口：找出缺少測試的特定函式、條件分支、錯誤處理路徑與邊界情況
3. 生成缺少的測試：建立針對未覆蓋程式碼的測試
4. 驗證覆蓋率改善：執行測試以確認覆蓋率提升

Verdent 找出的內容：

• 未測試的函式：完全沒有測試覆蓋的函式
• 條件分支：if/else 陳述式中某一分支未被測試
• 錯誤處理路徑：沒有失敗測試的 try/catch 區塊或錯誤回呼
• 邊界情況：邊界值、null/undefined 處理、型別強制轉換
• 整合點：API 呼叫、資料庫操作、外部服務互動

範例覆蓋率改善：

Improve test coverage for the UserService class

Verdent 找出：

• getUserById 有針對有效 ID 的測試，但沒有針對無效 ID 的測試
• updateUser 缺少驗證失敗的測試
• deleteUser 缺少授權檢查的測試
• createUser 中的錯誤處理路徑未被測試

接著生成專門針對這些缺口的測試，將覆蓋率從 65% 提升至 95%。

覆蓋率指標：

Verdent 協助你達到更高的覆蓋率百分比，並在先前未測試的程式碼中捕捉潛在錯誤：

• 行覆蓋率：測試所執行的程式碼行數百分比
• 分支覆蓋率：被測試的條件分支百分比
• 函式覆蓋率：至少有一個測試的函式百分比
• 陳述式覆蓋率：被執行的陳述式百分比

使用 Verdent 除錯

Verdent 透過分析錯誤訊息、追蹤執行流程、找出根本原因並建議修正來協助除錯。貼上錯誤日誌、描述非預期行為，或要求 Verdent 調查特定問題。

This function returns undefined instead of the user object. Debug it.

The login form redirects to the home page even when credentials are invalid

The product search is slow when the database has 10,000+ products

Why does this API endpoint return a 500 error when the email parameter is missing?

從錯誤訊息與日誌診斷

將錯誤訊息、堆疊追蹤或日誌檔案直接貼入聊天中。Verdent 會分析錯誤、找出來源檔案與行號、解釋原因並建議修正。

TypeError: Cannot read property 'name' of undefined
    at UserProfile.render (UserProfile.jsx:45)
    at processComponent (react-dom.js:2103)

I'm getting this error: [paste stack trace]

Analyze these logs and tell me why the API requests are failing:
[paste 50 lines of log output]

The shopping cart total is sometimes incorrect. Here are the error logs: [paste logs]

最佳實務

另請參閱