React 介面由某次 render 的 state 快照重新計算。Setter 安排工作,不會改寫已在執行的 handler 捕獲的局部變量。Key 決定 React 可保留哪個兄弟項目的身份;Effect 則把已提交的 UI 與 React 以外系統同步。混淆任何一條時間線,都可能令看似正確的程式有出乎意料的行為。
替換值與 updater 函式
考慮某次已提交 render 的同步事件處理器,當時 n 是 3。兩個 setN(n+1) 都使用該 handler 捕獲的 3 計算,各自把替換值 4 加入佇列;依次套用兩次替換後為 4,不是 5。相反,setN(v => v+1) 加入一條更新指令。React 將它作用於待處理值,第二個 updater 會收到第一個 updater 的結果;兩次遞增令 3 變 5。調用後 handler 的局部 n 仍為 3,之後的 render 才收到結果。
定義 6.2.1
(替換值與 updater 函式)
直接傳給 state setter 的值(例如 setN(4))是替換值:它捨棄待處理的 state,並提供下一個 state。傳給 setter 的函式(例如 setN(v => v + 1))是 updater 函式:React 以佇列中較早更新所得的待處理 state 調用它,並把它的返回值當作新的待處理 state。
Updater 應是純函式:描述狀態轉移,不修改外部狀態,也不突變舊值。開發環境 Strict Mode 下 React 可能調用 updater 兩次以偵測不純操作,其中一次結果會被忽略。這項檢查不允許把須恰好執行一次的副作用放在 updater 中。需要因行動執行一次的網絡寫入或 log,應放在適當設計的事件或外部系統邏輯中,而不是 updater。
常見錯誤
(在 setter 之後立即讀取狀態變量)
調用 setN(n + 1) 之後,若 handler 接著調用 save(n),送出的是舊值。若 n 原為 3,佇列中的替換值是 4,但 handler 裏的 n 仍是 3,所以 save 收到 3。應先計算一次下一個值,例如 const next = n + 1;,然後 setN(next) 和 save(next) 都使用 next。在 setter 之後讀取 n,描述的是正在結束的那次 render,而不是下一次要渲染的狀態。
例題:混合佇列
例題 6.2.2
(混合佇列)
某次 render 的 n=3,一個 handler 依次調用:
setN(n + 2);
setN(v => v * 2);
setN(n - 1);
setN(v => v + 4);
假設同一 state 的更新按此順序處理:第一個替換值是 5,updater 令其變 10;下一個替換值是 2,因為它由原快照 3 計算;最後 updater 令其變 6。下一個結果 state 是 6。同一 handler 後面的 console.log(n) 仍記錄 3。本例說明佇列的值與次序,不聲稱任意不同事件或所有非同步更新都屬一個不可分交易。
概念視角代數
把佇列看作函式的複合
把每次 setter 調用看作狀態上的函式:setN(4) 是把任何狀態送到 的常函式,setN(v => v + 4) 則是 。下一個狀態就是依次複合這些函式後,作用於該次 render 的狀態。上例為 。兩個 把 送到 ,而兩次替換為 只把 送到 。
複製改變的路徑,不只改外層名稱
State 陣列與物件都是參照。假設 items 含紀錄 A、B,只需改變 B 的 done。函式式更新可 map 舊陣列,為 B 返回一個切換後的新物件,A 則原樣返回。這會建立新外層陣列並保留舊快照;若只複製外層再突變共用的 B,仍會改變較早快照;突變後設定同一陣列參照,也可能因身份相同令 React 跳過更新。
這不是說每次更新都須複製所有巢狀物件。只複製內容發生改變的路徑上的每層容器;身份仍有效的未改物件可以重用。若 state 深層巢狀或數據在多處重複,較扁平的表示或單一擁有者可減少須保持一致的路徑。Props 是唯讀輸入;子元件應透過 callback 要求改變,而不是修改父元件紀錄。
Key 在位置敏感的樹中識別兄弟
React 把 state 關聯到渲染樹的元件位置及身份。Keys 在 reconciliation 時區分兄弟;穩定的數據 ID 可令前一項移除或列表重排時,項目仍保留應有身份。Key 是特殊的 reconciliation 資訊,並非普通 prop;子元件若需讀取 ID,仍須另行傳入。Keys 只需在相關兄弟之間唯一;每次 render 隨機產生新 key 則要求新身份,可能重設局部 state。真正 unmount 後再 mount 的元件,穩定 key 也不保證其舊 state 留存;把草稿提升至共同擁有者是保留它的一種方法。
例題:移除第一行
例題 6.2.3
(移除第一行)
A、B、C 各有一個由子元件持有的草稿。
| Key 方案 | 移除前(key:紀錄) | 移除 A 後 |
|---|---|---|
| 陣列索引 | 0:A,1:B,2:C | 0:B,1:C |
| 穩定紀錄 ID | A:A,B:B,C:C | B:B,C:C |
起初索引 keys 0、1、2 分別對應 A、B、C;移除 A 後,B 在索引 key 0,C 在 key 1。React 可把原先 key 0 的元件重用給 B,因而 A 的草稿可能出現在 B 旁。若用穩定 keys A、B、C,移除後 B、C 的身份仍對應各自紀錄。若篩選令 B 離開樹,之後再放回,B 先前子元件的局部 state 未必跨 unmount 留存;若需要該行為,可在父元件按 B 的 ID 保存。穩定 keys 解決同時存在的兄弟之間如何匹配,並非所有生命週期變化中的持久儲存。
Effect 擁有一對 setup–cleanup
Render 負責計算描述,不應在 render 作為副作用啟動 timer 或連接。Effect 讓已提交元件與外部系統同步。Setup 可訂閱或啟動 timer;cleanup 應準確撤銷該次 setup。依賴改變時,React 先執行舊 cleanup,再為新依賴建立同步;元件移除時亦執行 cleanup。依賴清單反映 Effect 讀取的 reactive values,不只是性能偏好。
例題:切換訂閱
例題 6.2.4
(切換訂閱)
各次已提交 render 及其 Effect 調用如下:
- 以
roomIdA 掛載:setup 訂閱 A。 - 以
roomIdB 提交:先由上一次的 cleanup 取消 A,再由 setup 訂閱 B。 - 移除元件:B 那次 setup 的 cleanup 取消 B。
元件的 Effect 以 roomId 為依賴,訂閱房間 A,並返回取消同一房間訂閱的函式。已提交變更由 A 切至 B 時,預期次序是取消 A,再訂閱 B;元件移除時取消 B。若 cleanup 反而讀取可變全局「目前房間」,可能取消 B 卻留下 A。應捕獲每次 setup 建立的資源,由其自己的 cleanup 關閉。空依賴清單不會在房間 prop 改變時重新同步;省略依賴參數則會在每次已提交 render 後執行 Effect,而不只在房間變更時執行。
在應用根部啟用的開發 Strict Mode 下,初次 Effect 還會經歷 setup–cleanup–setup 檢查。正確 cleanup 令檢查後只剩一個有效訂閱,而非兩個。這是開發壓力測試,不代表每次 production 更新都須有相同序列。某些工作由特定點擊觸發,而不是由元件可見觸發;不要只為稍後執行便把每個事件都移到 Effect。
反例模式
空依賴清單不等於正確地只連線一次
有人聲稱:對於連接 roomId 的 Effect,依賴清單 [] 是對的,因為連線只應建立一次。逐步追蹤:掛載時 roomId 是 general,setup 連接 general。之後房間改為 travel,元件重新 render。React 把依賴清單 [] 與上一次的 [] 比較,沒有差異,於是 cleanup 和 setup 都不執行。畫面顯示 travel,唯一開著的連線卻仍然是 general;元件移除時,cleanup 中斷 general,而 travel 從未連接。這個 Effect 讀取了 roomId,所以 [roomId] 才是準確的清單,追蹤結果便成為:連接 general、中斷 general、連接 travel、中斷 travel。
實用推理次序
先確認哪次 render 建立了 handler,以及它捕獲甚麼值;再依次寫出排隊的替換值與 updater 函式。接著判斷每個有 key 的兄弟對應哪個數據身份、元件是否持續 mount。最後把每次 Effect setup 與它建立的確切資源之 cleanup 配對。這四個問題能解釋 state 行為,而不把 render、事件與外部訂閱當成同時發生的一件事。
Timer 閉包與 cleanup 是兩個問題
假設元件以 count=0 render,並在空依賴清單的 Effect 安裝一個 interval。回調含 setCount(count + 1),它閉合於安裝該 interval 的 render 所提供的值,因此每次 tick 都要求替換為 1;之後 render 的 count 不會自動進入舊閉包。把回調改成 setCount(v => v + 1),每次 tick 便描述對待處理 state 的遞增。這本身仍不會在移除元件時取消 interval;setup 必須返回 cleanup,清除該次 interval 的確切 ID。
例題:計算 interval 生命週期
假設修正後的 updater 從 0 開始,三個 timer callbacks 按序處理,沒有其他更新,顯示 state 最終為 3。若回調使用捕獲的 count + 1,每次都要求 1,結果維持 1。Unmount 時,正確 cleanup 以該 Effect 自己的 setup 返回的 ID 調用 clearInterval。在應用根部的開發 Strict Mode 中,初始 setup–cleanup–setup 依次建立 interval、清除它、再建立替代者,檢查後有一個有效 interval。若漏掉 cleanup,可留下兩個有效 interval,令 ticks 看似加倍。瀏覽器節流意味任何一例都不保證牆鐘時間精度。
如果 Effect 確實讀取會改變的 roomId,為避免重新連線而給空依賴陣列並非正確修正:它仍在同步舊房間。應把需要的 reactive 值放入依賴清單,讓 cleanup 撤銷該次 setup 建立的連接。若某個值可以直接由 props 或 state 在 render 期間計算,另存一份再用 Effect 同步可能造成可避免的過時中間狀態。Effect 用來與外部系統同步;純推導值通常不需要 Effect。
例題:身份也取決於類型和位置
父元件先在樹中某位置渲染 <Editor key="A" />,再在同一位置渲染 <Preview key="A" />。相同 key 不會把不同元件類型變成同一元件;editor 被移除,其局部 state 不會轉移至 preview。反之,在匹配的兄弟位置再次渲染同一有 key 的 Editor,即使 props 改變,也可保留其局部 state。Key 只在兄弟範圍內生效,不是全局數據庫身份;元素類型或樹位置改變時 React 可能重設 state。若須在真正移除或類型改變後保留草稿,應交給持續 mount 的擁有者,或以穩定紀錄 ID 明確持久化。
因此佇列追蹤結果正確,不代表列表追蹤也正確:前者問值如何依次化簡,後者問哪個元件身份收到該值。除錯 effects 或 render 性能前,應同時檢查兩者。
練習
快速檢查
(兩個替換值與一個 updater)
某次 render 的 n 是 1,一個 handler 依次調用 setN(n + 1)、setN(n + 1) 和 setN(v => v * 3)。下一個 state 是多少?若同一 handler 在這些調用之後執行 console.log(n),會印出甚麼?
解答
兩個替換值都由捕獲的 1 計算,各自提供 2;之後待處理 state 是 2。Updater 收到這個待處理 state,返回 6,所以下一個 state 是 6。Log 印出 1,因為 handler 的 n 屬於建立該 handler 的那次 render,setter 調用不會重新賦值給它。
快速檢查
(不突變地切換一筆紀錄)
State items 是 [{ id: "a", done: false }, { id: "b", done: false }]。寫出一個切換 b 的 done 的函式式更新,並說明新 state 中哪些物件是新建的、哪些被重用。
解答
一個正確的更新是 setItems(prev => prev.map(item => item.id === "b" ? { ...item, done: !item.done } : item))。外層陣列是新的;b 紀錄是 done: true 的新物件;a 紀錄仍是原來的物件,因為其內容沒有改變。若寫 prev[1].done = true 再調用 setItems(prev),就會突變較早的快照,並傳入同一陣列參照,React 可能因此跳過更新。
快速檢查
(在最前面插入後的索引 keys)
B、C 兩行各在子元件 state 中持有已輸入的草稿,並以索引作 key 渲染。現在在最前面插入新行 A。更新後 A、B、C 旁邊分別顯示哪份草稿?
解答
插入後 A 的 key 是 0,B 是 1,C 是 2。React 重用原先 key 0 的元件,所以 B 的草稿出現在 A 旁;key 1 的元件保留 C 的草稿,現在顯示在 B 旁;key 2 是新的,所以 C 以空白草稿掛載。改用每筆紀錄的穩定 ID 作 key,每份草稿便會跟隨其紀錄。
快速檢查
(為每次 setup 配對 cleanup)
某個 Effect 的依賴清單是 [roomId],它執行 const connection = createConnection(roomId); connection.connect();,並返回 () => connection.disconnect()。在正式環境中,roomId 由 general 變為 travel,之後元件被移除。按次序列出連接相關的調用。
解答
調用次序是:連接 general;中斷 general;連接 travel;中斷 travel。每次 cleanup 都關閉其自身 setup 建立的連接物件,因此舊房間必定在新房間連接前中斷。在啟用根 Strict Mode 的開發環境中,初次掛載會在最終連接前多做一次 general 的連接與中斷;之後仍只有一個連接處於活動狀態。
快速檢查
(修正過時的 interval)
某個依賴清單為空的 Effect 執行 setInterval(() => setCount(count + 1), 1000),並且沒有返回任何東西。指出兩個缺陷,並寫出修正後的 Effect 內容。
解答
第一,callback 捕獲了安裝它的那次 render 的 count,所以每次觸發都要求替換值 1,顯示停在 1。第二,沒有任何東西清除 interval,元件移除後它仍繼續執行,而開發環境的 Strict Mode 檢查會留下兩個活動的 interval。修正後的內容是 const id = setInterval(() => setCount(c => c + 1), 1000); return () => clearInterval(id);。由於 Effect 不再讀取 count,空依賴清單現在是準確的。