LESSON-18 · TOPIC 03

防止重複送出

能用 in-flight 狀態與 disabled 控制,讓快速連按兩次只建立一個送出工作,結束後恢復操作。

code-edit表單驗證與可恢復非同步狀態|防止重複送出本頁只練一個責任

本頁只練什麼

能用 in-flight 狀態與 disabled 控制,讓快速連按兩次只建立一個送出工作,結束後恢復操作。

重複 request 可能產生兩筆名單、兩封通知或重複扣款;只改按鈕文字不能建立真正的程式邊界。

要修改的檔案:files/starter/main.js

定位:先把 attempts 與真正呼叫 transport 的 sendCount 分開記錄。|依 starter-3 定位,只修改「防止重複送出」的責任。

任務情境

先結果,再原理;完成後要能說出自己看見的證據。

現在的問題

網路較慢時使用者連按兩下,試算表出現相同聯絡資料兩列。

起始狀態:按鈕可用、inFlight=false、sendCount=0。

完成後要看到

attempts=2、sendCount=1、disabledDuring=true、restored=true。

驗收證據:attempts=2、sendCount=1、disabledDuring=true、restored=true

何時會用到

任何 fetch 表單、付款、建立訂單或會改變後端資料的非同步操作。

常見混淆:disabled 只限制使用者介面;handler 仍需 guard,因為程式或其他入口仍可能再次呼叫。

觀念與最小範例

這段程式是理解起點,不是要你直接跳過 Starter。

防止重複送出 Duplicate submission guard

第一份送出還在路上時,第二次按下要被擋住;不可以再寄一份。

正式說法:以共享 inFlight guard 建立 critical section,並在 async operation 的 finally 恢復 UI state。

if (inFlight) return; inFlight=true; button.disabled=true; try { await send(); } finally { inFlight=false; button.disabled=false; }

三步完成本主題

每一步都留下可觀察結果;如果沒看到,先看「卡住先查」。

  1. Step 1|先看見目前缺口,不急著貼答案。

    檔案:files/starter/main.js 定位:先把 attempts 與真正呼叫 transport 的 sendCount 分開記錄。

    要做:先重新載入 Starter,記錄目前畫面、DOM、Computed、Console 或文件內容。

    預期:能指出「先把 attempts 與真正呼叫 transport 的 sendCount 分開記錄。」目前的缺口。

    證據:保存 files/starter/main.js 的目前狀態,並指出下一步只會修改哪個檔案責任。

    卡住先查:確認開啟的是 files/starter/main.js,且定位到 先把 attempts 與真正呼叫 transport 的 sendCount 分開記錄。。

  2. Step 2|只修改本主題的一個責任。

    檔案:files/starter/main.js 定位:先把 attempts 與真正呼叫 transport 的 sendCount 分開記錄。

    要做:在同一個未完成 Promise 期間呼叫 handler 兩次,驗證第二次被 guard 擋下且 finally 恢復按鈕。

    預期:attempts=2、sendCount=1、disabledDuring=true、restored=true。

    證據:attempts=2、sendCount=1、disabledDuring=true、restored=true

    卡住先查:先把 attempts 與真正呼叫 transport 的 sendCount 分開記錄。

  3. Step 3|重新載入並以證據驗收,不以『看起來差不多』判定完成。

    檔案:files/starter/main.js 定位:先把 attempts 與真正呼叫 transport 的 sendCount 分開記錄。

    要做:重新整理頁面,再逐項比對預期結果與 evidence。

    預期:attempts=2、sendCount=1、disabledDuring=true、restored=true。

    證據:attempts=2、sendCount=1、disabledDuring=true、restored=true

    卡住先查:先把 attempts 與真正呼叫 transport 的 sendCount 分開記錄。

觀察示範

這個示範只讓你看懂概念,不會替你修改 Starter,也不會自動宣告完成。

防止重複送出runtime fixture · read-only demo
本主題示範畫面:

驗收證據

勾選只是學習紀錄;真正完成仍要回到 Starter 的實際結果。

提示 1|方向

第二次 handler 應在呼叫 transport 前就 return。

提示 2|關鍵片段

guard 與 disabled 在 try 前設定,兩者都在 finally 恢復。

提示 3|完整解答與原因

完整解答與原因:第一次將 inFlight=true 並 disabled 後才 await transport;第二次看到 guard 直接 return;finally 恢復狀態,所以 attempts=2 但 sendCount=1。

完成後進入下一階段,或回到入口選下一個 topic。

開始 Starter →回到主題清單