在使用 ASP.NET 開發網站時,內建的 Ajax 控制項,例如 UpdatePanel,有時會拋出逾時相關的例外,例如 Sys.WebForms.PageRequestManagerParserErrorException。這類錯誤對開發人員來說可能很熟悉,但對一般使用者而言,往往只會看到一個莫名其妙的錯誤訊息。
如果沒有妥善處理,使用者可能會看到框架預設的錯誤提示,甚至不知道接下來該做什麼。因此,比較好的做法,是在用戶端攔截這類例外,並導向重新載入頁面或顯示友善提示。
可以透過 Sys.WebForms.PageRequestManager 的執行個體,取得目前頁面要求管理員。接著註冊 endRequest 事件,在事件處理函式中檢查 args.get_error() 是否存在。若存在,就取得錯誤訊息,並判斷是否為 PageRequestManagerParserErrorException。
如果確認是這類錯誤,可以執行 window.location.reload,讓頁面重新載入。接著呼叫 args.set_errorHandled(true),避免框架再跳出預設的逾時提示框。
這段程式碼建議放在 form 標籤與 body 標籤之間。如果放在太前面,可能會出現 Sys 未定義的 JavaScript 錯誤。若網站使用母版頁,也可以把這段程式碼放到母版頁中,讓所有頁面共用。
若要重現問題,可以先把處理腳本註解掉,再觸發 Ajax 逾時情境,就能觀察到 PageRequestManagerParserErrorException 的錯誤訊息。透過這個方式,也能確認捕捉程式是否真的生效。
整體來說,這個做法的重點不是消滅錯誤,而是把錯誤轉換成使用者可以理解的處理流程。對於需要長期維護的網站來說,這類細節往往會直接影響使用體驗。