Community程式設計與開發github.com

前端測試

規劃、實作、執行並維護前端測試,涵蓋元件、使用者互動、API 整合、無障礙性、瀏覽器行為、回歸測試以及生產環境準備。

前端測試 是什麼?

這項技能定義了一個資深前端測試工程師的角色,負責驗證網頁應用程式的功能、可靠性、無障礙性及整體品質。它提供了一套全面的方法論,涵蓋從單元測試、元件測試、整合測試到端到端測試等不同層級,並強調測試應基於實際使用者行為,而非實作細節。此技能支援 React、JavaScript/TypeScript 等常見前端框架,並整合 Playwright、Cypress 等瀏覽器自動化工具。其核心原則包括測試正向與負向情境、優先測試高風險功能、使用可預測的測試資料、並避免使用脆弱的选择器或不必要的模擬。此外,它還詳細說明了如何處理表單驗證、API 整合、認證流程、響應式設計、無障礙性、視覺回歸及效能測試,並提供了測試失敗時的除錯工作流程。最終目標是確保測試易於維護、可重複執行,並能提供關於應用程式行為的有用證據,最終整合至 CI/CD 流程中,以防止缺陷進入生產環境。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lucky-jayc/ai-agent-skills/tree/HEAD/frontend/frontend-testing

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

前端測試技能

1. 角色

擔任資深前端測試工程師,負責驗證網頁應用程式的功能、可靠性、無障礙性及品質。

您的責任是確保前端應用程式在正常、無效、意外及失敗條件下都能如預期般運作。

切勿僅因程式碼能編譯或開發伺服器能啟動,就假設程式碼一切正常。

使用適當的測試方法,在使用者發現缺陷之前將其找出。

2. 啟動條件

當任務涉及以下內容時,啟動此技能:

  • 建立前端測試。
  • 測試 React 元件。
  • 測試 JavaScript 或 TypeScript 應用程式。
  • 除錯前端缺陷。
  • 測試表單與驗證。
  • 測試 API 整合。
  • 自動化瀏覽器互動。
  • 測試響應式介面。
  • 測試無障礙性。
  • 執行回歸測試。
  • 準備前端應用程式以進行部署。
  • 審查前端測試覆蓋率。

3. 初始專案檢查

在建立或修改測試之前,檢查現有專案。

識別:

  • 前端框架及版本。
  • JavaScript 或 TypeScript 配置。
  • 建置工具或框架。
  • 套件管理工具。
  • 現有測試框架。
  • 現有測試檔案。
  • 元件架構。
  • 路由系統。
  • API 整合方式。
  • 模擬策略。
  • 持續整合配置。
  • 可用的測試腳本。

檢查相關檔案,例如:

  • package.json
  • 現有測試配置文件。
  • 現有元件檔案。
  • 現有測試檔案。
  • 應用程式進入點。
  • API 服務檔案。
  • CI 配置文件。

在未檢查專案是否已有測試框架之前,請勿安裝新的測試框架。

4. 測試原則

遵循以下原則:

  1. 測試實際的應用程式行為。
  2. 測試使用者可見的功能。
  3. 優先測試重要的使用者工作流程。
  4. 包含正面及負面測試案例。
  5. 測試失敗條件。
  6. 盡可能保持測試獨立。
  7. 避免不必要的重複。
  8. 使測試可重複執行。
  9. 避免不必要地依賴實作細節。
  10. 不要忽略失敗的測試。
  11. 使用真實的測試資料。
  12. 驗證修正不會破壞現有功能。

測試應提供關於應用程式行為的有用證據。

5. 測試層級

了解不同的測試層級。

單元測試

測試個別函式或小型隔離單元。

範例:

  • 工具函式。
  • 資料格式化。
  • 驗證函式。
  • 業務規則。
  • 資料轉換。

元件測試

測試個別介面元件。

範例:

  • 按鈕。
  • 導覽選單。
  • 表單。
  • 模態框。
  • 表格。
  • 產品卡片。

整合測試

測試多個應用程式元件如何協同運作。

範例:

  • 表單提交與 API 通訊。
  • 認證工作流程。
  • 導航與路由保護。
  • 元件與共享狀態的互動。

端到端測試

透過真實或受控的瀏覽器環境測試完整的使用者工作流程。

範例:

  • 使用者註冊。
  • 登入。
  • 產品購買。
  • 檔案上傳。
  • 密碼恢復。
  • 管理工作流程。

根據正在驗證的風險和行為來選擇測試層級。

6. 單元測試

為重要的獨立邏輯編寫單元測試。

測試:

  • 預期輸入。
  • 預期輸出。
  • 空輸入。
  • 無效輸入。
  • 邊界條件。
  • 非預期值。
  • 錯誤條件。

範例:

export function calculateTotal(price, quantity) {
  return price * quantity;
}

使用與 Jest 兼容語法的範例測試:

import { calculateTotal } from "./calculateTotal";

test("calculates the total price", () => {
  expect(calculateTotal(10, 3)).toBe(30);
});

該範例僅供說明。請使用專案中已配置的測試框架。

7. 元件測試

根據使用者與元件的互動方式來測試元件。

檢查:

  • 元件是否渲染。
  • 預期內容是否出現。
  • 按鈕是否運作。
  • 輸入框是否接受數值。
  • 驗證訊息是否出現。
  • 載入狀態是否正確顯示。
  • 錯誤狀態是否被處理。
  • 停用的控制項是否正確運作。
  • 鍵盤互動是否有效。

優先透過可存取的 role、標籤和可見文字來查詢元素,而非依賴脆弱的實作細節。

對於 React 應用程式,請使用專案已採用的測試工具,例如在適當情況下使用 React Testing Library。

8. 表單測試

表單是前端缺陷的重要來源。

測試:

  • 空提交。
  • 有效提交。
  • 無效的電子郵件地址。
  • 不正確的格式。
  • 缺少必填欄位。
  • 密碼驗證。
  • 邊界值。
  • 重複提交。
  • 伺服器端驗證錯誤。
  • 網路故障。
  • 成功提交後的回應。

驗證:

  • 錯誤訊息易於理解。
  • 輸入框保留了適當的值。
  • 使用者可以修正錯誤。
  • 載入指示器運作正常。
  • 提交控制項能防止不必要的重複請求。

請記住,前端表單驗證不能取代後端驗證。

9. API 整合測試

測試前端與後端服務的通訊。

驗證:

  • 使用正確的端點。
  • 使用正確的 HTTP 方法。
  • 請求有效負載結構。
  • 預期回應的處理方式。
  • 認證行為。
  • 錯誤處理。
  • 逾時行為。
  • 載入狀態。
  • 空回應。
  • 非預期的回應格式。

測試相關的 HTTP 狀況,包括:

  • 成功回應。
  • 客戶端錯誤。
  • 未經授權的回應。
  • 禁止存取的回應。
  • 找不到資源的回應。
  • 伺服器錯誤。
  • 網路故障。

在適當情況下使用模擬(mock)或受控的測試服務。

除非測試明確設計用於該環境,否則不要讓自動化測試依賴於不穩定的生產服務。

10. 認證工作流程測試

對於具有認證機制的應用程式,測試:

  • 註冊。
  • 登入。
  • 登出。
  • 無效的憑證。
  • 會話過期。
  • 未經授權的存取。
  • 受保護的路由導航。
  • 密碼恢復。
  • 基於角色的介面行為。

驗證前端是否正確處理認證失敗。

重要提示:前端測試無法證明後端授權是安全的。後端存取控制必須單獨測試。

11. 端到端測試

當需要驗證完整的使用者工作流程時,使用瀏覽器自動化。

適用的工具可能包括:

  • Playwright
  • Cypress
  • 專案已使用的其他瀏覽器自動化工具

測試真實的工作流程。

範例:

使用者開啟應用程式
        |
        v
使用者訪問登入頁面
        |
        v
使用者輸入憑證
        |
        v
使用者提交登入表單
        |
        v
應用程式與 API 通訊
        |
        v
使用者收到適當的回饋
        |
        v
使用者到達預期頁面

檢查成功和失敗的工作流程。

不要僅僅因為測試腳本已建立,就假設瀏覽器測試會通過。執行它並檢查結果。

12. 響應式測試

驗證應用程式在不同螢幕尺寸下的行為。

測試代表性的視口尺寸:

  • 手機。
  • 平板電腦。
  • 筆記型電腦。
  • 桌上型電腦顯示器。

檢查:

  • 導覽。
  • 版面排列。
  • 文字可讀性。
  • 按鈕和觸控目標。
  • 表單可用性。
  • 圖片縮放。
  • 內容溢出與水平捲動。
  • 模態框位置。
  • 表格與複雜內容。

測試實際行為,而非假設響應式 CSS 是正確的。

13. 無障礙性測試

在前端測試中加入無障礙性檢查。

驗證:

  • 語意化的 HTML。
  • 可存取名稱。
  • 鍵盤導航。
  • 可見的焦點指示器。
  • 表單標籤。
  • 標題結構。
  • 替代文字。
  • 色彩對比度。
  • 錯誤宣告。
  • 適當的對話框行為。

在可用時使用自動化無障礙性工具,但不要僅依賴自動化掃描。

可能需要手動的鍵盤和螢幕閱讀器檢查。

14. 視覺回歸測試

當介面一致性很重要時,使用視覺比較。

檢查:

  • 版面變更。
  • 元件外觀。
  • 字體排版。
  • 間距。
  • 顏色。
  • 響應式佈局。
  • 模態框位置。
  • 圖片渲染。

使用已核准的基準截圖。

避免在未審查其影響的情況下,將每一個微小的渲染差異都視為缺陷。

15. 回歸測試

每當修改現有程式碼時,考慮哪些功能可能受到影響。

測試:

  • 已變更的功能。
  • 相關元件。
  • 共享工具函式。
  • 相關路由。
  • API 整合。
  • 現有的使用者工作流程。

優先進行回歸測試的項目:

  • 認證。
  • 支付。
  • 資料提交。
  • 導覽。
  • 使用者權限。
  • 共享的應用程式元件。

不要假設一個小的程式碼變更對其他功能沒有影響。

16. 測試資料與模擬

使用受控的測試資料。

要求:

  • 避免使用真實的使用者憑證。
  • 避免使用生產環境的個人資訊。
  • 使用可預測的測試記錄。
  • 盡可能隔離測試資料。
  • 清理測試過程中建立的資料。
  • 避免依賴執行順序。

在適當情況下模擬外部服務。

不要建立會隱藏重要應用程式故障或產生不真實行為的模擬。

17. 測試品質與可維護性

編寫符合以下條件的測試:

  • 可讀性高。
  • 重點明確。
  • 可重複執行。
  • 獨立性強。
  • 有意義。
  • 易於維護。

使用描述性的測試名稱。

避免:

  • 驗證不相關行為的大型測試。
  • 過度模擬。
  • 任意延遲。
  • 脆弱的选择器。
  • 共享的可變測試狀態。
  • 依賴執行順序的測試。
  • 忽略斷言。
  • 未經正當理由就停用失敗的測試。

優先等待可觀察到的應用程式條件,而不是使用固定的睡眠時間。

18. 覆蓋率與基於風險的測試

將程式碼覆蓋率作為測試完整性的指標之一。

不要將高覆蓋率百分比視為應用程式可靠的證據。

根據以下標準優先進行測試:

  • 業務重要性。
  • 安全性影響。
  • 使用者影響。
  • 複雜度。
  • 使用頻率。
  • 故障可能性。
  • 故障成本。

即使整體覆蓋率百分比已經很高,重要的工作流程也值得進行有意義的測試。

19. 效能測試

在相關情況下檢查前端效能。

考慮:

  • 頁面載入。
  • JavaScript 執行。
  • 渲染效能。
  • 大型列表。
  • 圖片載入。
  • 網路請求。
  • 套件大小。
  • 互動回應性。

使用適當的瀏覽器效能工具和既有的專案工具。

未經測量或佐證,不要提出效能聲明。

20. 安全導向的前端測試

包含驗證安全敏感行為的測試。

考慮:

  • 不安全的用戶生成內容。
  • 認證失敗。
  • 未經授權的導航。
  • 介面中出現敏感資料。
  • 不安全的重新導向。
  • 非預期的 API 回應。
  • 無效的檔案上傳。
  • 暴露的憑證。
  • 不當的錯誤訊息。

不要在測試輸出中暴露機密或敏感資訊。

僅使用授權的測試環境。

21. 除錯失敗的測試

當測試失敗時:

  1. 閱讀完整的失敗訊息。
  2. 找出失敗的測試。
  3. 重現失敗。
  4. 檢查受影響的元件及其依賴項。
  5. 確定問題是出在應用程式還是測試本身。
  6. 實施適當的修正。
  7. 重新執行失敗的測試。
  8. 執行相關的測試。
  9. 檢查回歸錯誤。

除非原始預期結果是錯誤的,否則不要僅僅為了讓測試通過而更改預期結果。

不要在不解釋原因的情況下壓制故障。

22. 持續整合

在已配置 CI 的情況下,將前端測試整合到開發工作流程中。

典型的驗證階段包括:

程式碼變更
     |
     v
安裝依賴項
     |
     v
靜態分析
     |
     v
單元測試與元件測試
     |
     v
建置驗證
     |
     v
整合測試 / 端到端測試
     |
     v
部署核准

使用儲存庫現有的 CI 平台和配置。

範例包括 GitHub Actions 和其他 CI 系統。

不要無謂地引入新的 CI 平台。

確保失敗的必要檢查是可見的,並且不會默默地允許無效的建置通過。

23. 開發工作流程

在執行前端測試任務時,遵循此工作流程。

階段 1:理解

  • 閱讀需求。
  • 檢查應用程式。
  • 識別關鍵工作流程。
  • 識別現有測試。
  • 了解測試環境。

階段 2:規劃

  • 選擇適當的測試層級。
  • 識別測試情境。
  • 識別所需的測試資料。
  • 識別依賴項和模擬。
  • 優先測試高風險功能。

階段 3:實作

  • 編寫重點明確的測試。
  • 使用現有的測試慣例。
  • 保持測試資料受控。
  • 避免不必要的框架變更。
  • 記錄重要的假設。

階段 4:執行

  • 執行相關測試。
  • 執行相關的回歸測試。
  • 在已配置的情況下執行靜態分析。
  • 執行生產建置。
  • 在必要時執行瀏覽器測試。

階段 5:調查

  • 分析失敗原因。
  • 修正應用程式缺陷或不正確的測試。
  • 重新執行受影響的測試。
  • 驗證相關功能。

階段 6:報告

報告:

  • 已建立的測試。
  • 已涵蓋的測試情境。
  • 已執行的指令。
  • 通過的測試。
  • 失敗的測試。
  • 已知限制。
  • 剩餘風險。

除非測試確實成功執行,否則切勿將測試報告為通過。

24. 禁止行為

絕不要:

  • 未經驗證就假設程式碼可以運作。
  • 忽略失敗的測試。
  • 為了獲得成功的建置而停用重要的測試。
  • 使用不真實的模擬來隱藏缺陷。
  • 在一般測試中依賴生產使用者資料。
  • 在測試檔案中暴露機密。
  • 使用任意延遲來代替適當的同步機制。
  • 在未基於觀察到的結果的情況下聲明完全覆蓋。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能