convertor/docs/測試/測試策略.md

測試策略

本文件說明 ConvertX-CN 的測試策略與方法。

---

測試類型

單元測試

測試獨立的函數與模組。

涵蓋範圍：

• 轉換器邏輯
• 工具函數
• 資料處理

整合測試

測試模組之間的協作。

涵蓋範圍：

• API 端點
• 資料庫操作
• 檔案處理

E2E 測試

模擬使用者操作的完整流程測試。

涵蓋範圍：

• 上傳檔案
• 轉換流程
• 下載結果

---

執行測試

前端測試

# 執行所有測試
bun run test

# 監視模式
bun run test:watch

# 覆蓋率報告
bun run test:coverage

API Server 測試（Rust）

cd api-server

# 執行所有測試
cargo test

# 詳細輸出
cargo test -- --nocapture

E2E 測試

# 執行 E2E 測試
bun run test:e2e

# 或使用腳本
./scripts/run-e2e-tests.sh

---

測試結構

tests/
├── converters/      # 轉換器測試
├── e2e/             # 端對端測試
└── transfer/        # 傳輸模組測試

api-server/tests/
├── api_tests.rs     # REST API 測試
├── graphql_tests.rs # GraphQL 測試
└── integration_tests.rs # 整合測試

---

測試範例

前端單元測試

// tests/converters/ffmpeg.test.ts
import { describe, it, expect } from "bun:test";
import { ffmpegConverter } from "../../src/converters/ffmpeg";

describe("FFmpeg Converter", () => {
  it("should support mp4 input", () => {
    expect(ffmpegConverter.inputFormats).toContain("mp4");
  });

  it("should support webm output", () => {
    expect(ffmpegConverter.outputFormats).toContain("webm");
  });
});

API 整合測試

// api-server/tests/api_tests.rs
#[tokio::test]
async fn test_health_endpoint() {
    let response = client.get("/health").send().await.unwrap();
    assert_eq!(response.status(), StatusCode::OK);
}

E2E 測試

// tests/e2e/upload.test.ts
import { test, expect } from "@playwright/test";

test("should upload and convert file", async ({ page }) => {
  await page.goto("/");

  // 上傳檔案
  await page.setInputFiles("#file-input", "test.docx");

  // 選擇格式
  await page.selectOption("#format", "pdf");

  // 點擊轉換
  await page.click("#convert-button");

  // 驗證結果
  await expect(page.locator(".download-link")).toBeVisible();
});

---

測試資料

測試檔案

放置在 tests/fixtures/ 目錄：

tests/fixtures/
├── documents/
│   ├── sample.docx
│   ├── sample.pdf
│   └── sample.txt
├── images/
│   ├── sample.png
│   └── sample.jpg
└── audio/
    └── sample.mp3

Mock 資料

使用 Mock 避免依賴外部服務：

import { mock } from "bun:test";

const mockConverter = mock(() => ({
  convert: async () => "output.pdf",
}));

---

持續整合

GitHub Actions

# .github/workflows/test.yml
name: Test

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: oven-sh/setup-bun@v1
      - run: bun install
      - run: bun run test

---

相關文件

• CI/CD
• E2E 測試
• 本地開發