React 和 TypeScript
將狀態放在一個地方
每個值都應只有一個擁有者。大多數 React 錯誤源自於同一筆資料有兩個不同拷貝且彼此不一致。
請用推導取代儲存。如果某個值可以在渲染期間從 props 和 state 計算出來,就應該計算它——不要將其鏡像到 useState,因為當其來源改變時,拷貝就會立即過時。const total = items.reduce(...) 無需 state 且永遠不會出錯。
從 prop 複製而來的 state 是同一種錯誤,只是延後爆發:useState 的初始值只會讀取一次,之後便永遠被忽略。如果元件必須在 prop 改變時重置,請為它提供一個 key 並讓 React 重新掛載它。
僅將 state 提升到需要它的最近共同父元件。提升得越遠,每次按鍵都會導致所有兄弟元件重新渲染。
Effect
Effect 用於與 React 外部的系統進行同步:訂閱、計時器、document 或命令式函式庫。它不是用來計算值或回應點擊的地方——那是事件處理函式的職責。
依賴陣列必須列出 Effect 讀取的所有內容。為了停止迴圈而省略某個值,會將其凍結在第一個值上,並產生閉包過時錯誤。如果因為依賴項是每次渲染都會重建的物件或函式而導致 Effect 陷入循環,請修正依賴項——使用 useCallback、useMemo,或將其移出元件——而不是從陣列中刪除它。
每當 Effect 啟動任何可能超出其生命週期的東西時,都應返回一個清理函數。訂閱、計時器和進行中的請求都需要在元件卸載或依賴項改變時停止;在開發模式下,StrictMode 會讓 Effect 執行兩次,正是為了暴露缺少清理函數的問題。
async 函式不能作為 Effect 主體——它會回傳一個 Promise,而 React 預期的是清理函數。請在 Effect 內部宣告非同步工作並呼叫它。
資料擷取
優先使用專案的資料函式庫,而不是在 Effect 中手動擷取;它已經解決了快取、去重、重試以及你即將遇到的競爭條件。
在手動擷取時,請處理所有四種狀態——載入中、空值、錯誤、成功——並在清理時取消請求。順序發起的兩個請求仍可能以亂序解析,因此要麼中止前一個請求,要麼忽略已非當前的回應。
絕不要吞沒 rejection。在處理函式或 Effect 中未處理的 rejection 會默默地失敗,UI 便停止更新。
渲染
使用資料中穩定的唯一標識符作為列表的 key。索引 key 僅在列表永不重新排序、插入或刪除時才是正確的;當列表變動時,React 會重用錯誤的 DOM 節點,導致輸入框保留前一行的值。
在使用剖析器測量之後,再考慮使用 memo、useMemo 和 useCallback。預設到處使用它們會增加配置和容易出錯的依賴陣列,而且在真實成本是父元件重新渲染整個樹的情況下,它們也無法解決問題。
絕不要在條件、迴圈或過早返回之後呼叫 Hook。其呼叫順序必須在每一次渲染中都完全相同。
TypeScript
將 any 和型別斷言視為未解決的問題,而非修正。兩者都在編譯器恰好有有用資訊要提供的地方讓它保持沉默。當型別確實未知時,請使用 unknown 並縮小其範圍。
對跨越邊界的資料定義型別:API 回應、表單值、URL 參數。來自網路的資料在經過檢查之前並非你所宣告的型別,因此請在邊界處進行驗證,並讓應用程式的其餘部分信任驗證結果。
驗證
建置成功所代表的意義比表面上看起來少。許多專案會將框架配置為在建置時忽略 lint 和型別錯誤,因此在將建置結果當作證據之前,請檢查配置,並明確執行型別檢查和 linter。
然後實際使用該元件:測試空狀態、錯誤狀態、慢速網路,以及在第一次互動完成之前進行第二次快速互動。