技術與測試 核心 B · 官方指南或詞彙 平台: 網頁

Error Boundary

錯誤邊界

錯誤邊界會接住元件樹中一小部分的畫面錯誤。它只在出錯位置顯示安全替代內容。

看看怎麼運作
也有人這樣說 Error Boundary元件錯誤邊界畫面錯誤替代內容當機邊界

看看怎麼運作

原創情境範例錯誤邊界

另一個例子

一張圖表發生錯誤。導覽和其他儀表板卡片仍可正常使用。

主要部分

  1. 01受保護的元件樹
  2. 02接住的錯誤
  3. 03局部替代內容
  4. 04仍可使用的相鄰區塊
  5. 05重新載入動作

什麼時候用

某個畫面區域可能單獨失敗時,可以在它外面放置錯誤邊界。

什麼時候不要用

不要用它處理一般表單錯誤或請求失敗。這些情況應有正常的錯誤狀態。

程式裡的名稱

protected subtree + caught render error + fallback + reset

上線前要檢查

檢查程式執行環境與版本、整合邊界、相依套件與授權,以及支援的平台。驗證安全、失敗處理、效能與監控。也要檢查部署、支援負責人、升級路徑與回復上一版的方法。

可以直接複製的需求

預期成果:把 錯誤邊界 (Error Boundary) 當成團隊能維護的技術基礎,並檢查它是否符合產品需求。 使用者情境:一張圖表發生錯誤。導覽和其他儀表板卡片仍可正常使用。 技術或工程概念:錯誤邊界 (Error Boundary)。 適用理由:某個畫面區域可能單獨失敗時,可以在它外面放置錯誤邊界。 不應使用的情況:不要用它處理一般表單錯誤或請求失敗。這些情況應有正常的錯誤狀態。 工程適配:定義程式執行環境與版本。說明它負責什麼、介面、資料流、相依套件、支援平台、安全與效能限制,以及如何接上現有技術組合。 生命週期防護:檢查相依套件是否健康、授權是否可用。加入監控與安全退路,並指定升級負責人。沒有可衡量的好處時,不要再加入功能重複的框架或工具。 驗收條件:用最小整合證明必要行為。測試相容性、安全性、失敗與效能。記錄部署、升級、支援與回復上一版的方法。 證據與限制(證據邊界):它只代表該來源的官方說法。其他平台或團隊可能有不同用法。 待確認:現有技術組合、執行環境、版本規則、目標平台和相依套件負責人。也要確認效能預算、支援期限與搬移限制。

檢查這份需求

請 AI 程式助手檢查目前如何使用 錯誤邊界 (Error Boundary)。 定義:錯誤邊界會接住元件樹中一小部分的畫面錯誤。它只在出錯位置顯示安全替代內容。 正式環境檢查:檢查程式執行環境與版本、整合邊界、相依套件與授權,以及支援的平台。驗證安全、失敗處理、效能與監控。也要檢查部署、支援負責人、升級路徑與回復上一版的方法。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。

B
這個術語有多正式?

官方指南或詞彙

列出的平台、框架、專案或專業組織,有發布這個術語的官方指南。

它只代表該來源的官方說法。其他平台或團隊可能有不同用法。

適用範圍
只包含來源有說明的內容:正式名稱、定義、平台 API、實作、使用指南
文件狀態
穩定
查證日期
2026-07-30

證據來源與適用範圍

正式來源 + 術語參考資料 · React · 穩定 Catching rendering errors with an error boundary 適用範圍: 正式名稱、定義、平台 API、實作、使用指南 本頁用途: 直接術語參考 來源涵蓋內容: 正式名稱, 定義, 平台 API, 實作, 使用指南

自行複製

瀏覽器無法自動複製。請選取下方文字,再自行複製。