convertor/tests/e2e/README.md
Your Name 840c215597 test(e2e): add End-to-End test suite
Added comprehensive E2E tests:

1. API E2E Tests (api.e2e.test.ts):
   - Healthcheck API testing
   - Static resources verification
   - Module loading tests
   - Converter properties validation
   - File type normalization tests
   - i18n module tests
   - Transfer module tests
   - Database structure tests

2. Converter E2E Tests (converters.e2e.test.ts):
   - Real Inkscape conversions (SVG → PNG/PDF/EPS)
   - Real Pandoc conversions (Markdown → HTML/DOCX/RST)
   - Dasel format conversions (JSON → YAML/TOML)
   - Batch conversion tests
   - Error handling tests
   - Auto-detection of available tools

3. Test Infrastructure:
   - helpers.ts: Tool detection, test file generation
   - fixtures/: Sample test files (SVG, MD, JSON)
   - .gitignore: Exclude output directory

Total: 34 new E2E tests
2026-01-23 00:14:31 +08:00

53 lines
1.3 KiB
Markdown

# E2E 測試 (End-to-End Tests)
此目錄包含端對端測試,用於驗證完整的轉換流程。
## 測試類型
### 1. 轉換器 E2E 測試 (`converters.e2e.test.ts`)
測試真實的檔案轉換,需要安裝對應的轉換工具:
- **Inkscape**: SVG ↔ PNG, PDF, EPS 等
- **ImageMagick**: 圖像格式轉換
- **LibreOffice**: 文件格式轉換
- **FFmpeg**: 音視頻轉換
- **Pandoc**: 文件格式轉換
### 2. API E2E 測試 (`api.e2e.test.ts`)
測試完整的 HTTP API 流程:
- 上傳檔案
- 啟動轉換
- 查詢狀態
- 下載結果
## 執行方式
```bash
# 執行所有 E2E 測試
bun test tests/e2e
# 只執行轉換器 E2E 測試
bun test tests/e2e/converters.e2e.test.ts
# 只執行 API E2E 測試
bun test tests/e2e/api.e2e.test.ts
```
## 環境要求
E2E 測試需要安裝實際的轉換工具。在 Docker 環境中運行可確保所有工具都已安裝。
測試會自動偵測可用的工具,跳過不可用的測試。
## 測試資料
測試使用 `tests/e2e/fixtures/` 目錄中的測試檔案。這些是小型的測試檔案,用於快速驗證轉換功能。
## 注意事項
1. E2E 測試比單元測試慢,通常只在 CI/CD 中運行
2. 測試會在 `tests/e2e/output/` 目錄中產生輸出檔案
3. 每次測試前會清理輸出目錄