頁面關閉時想順便通知伺服器一件小事(例如登出、記錄離開時間),是個很自然的需求,但實作起來經常會遇到「程式碼明明寫了,卻完全沒作用」的狀況。本文拆解它的成因與可行方案。
window.onunload = function() {
logout();
}
function logout(reqParam, callback){
var userManageServiceUrl = "https://" + getServerAddr() + "/axis2/services/UserManageService";
var urlList = window.location.href.split("?");
reqParam.sessionID = urlList[1];
var pl = new SOAPClientParameters();
pl.add("reqParam", JSON.stringify(reqParam));
SOAPClient.invoke(userManageServiceUrl, "logout", pl, true, callback);
}
invoke() 的最後一個參數控制同步/非同步。傳 true 代表非同步:前端發出請求後不會等回應,立刻往下執行。而頁面卸載的過程一旦開始,瀏覽器就會中止所有仍在進行中的連線,於是這個請求還沒被送出或還沒等到回應就消失了——看起來就像 logout() 沒被執行。
把參數改成 false(同步),讓瀏覽器等回應回來再關頁,問題確實會消失。但同步 XHR 會凍結 UI 執行緒,在卸載階段使用更是各瀏覽器明確不鼓勵、甚至直接忽略的行為,不建議採用。
方案一:navigator.sendBeacon,專為卸載階段設計,非同步、不阻塞關頁,並會自動帶上 cookies:
window.addEventListener('visibilitychange', function () {
if (document.visibilityState === 'hidden') {
var payload = new FormData();
payload.append('sessionID', sessionID);
navigator.sendBeacon(userManageServiceUrl, payload);
}
});
方案二:fetch + keepalive,keepalive 允許請求在頁面卸載後繼續完成:
fetch(userManageServiceUrl, {
method: 'POST',
keepalive: true,
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ sessionID: sessionID })
});
1. unload/beforeunload 在行動裝置上不可靠,iOS Safari 尤其明顯。改用 visibilitychange 搭配 hidden 狀態,涵蓋率好得多,也能兼顧切換 App、鎖屏等情境。
2. 卸載階段的請求可能被丟棄,因此不該承載關鍵業務。像登出這類狀態,最可靠的仍是伺服器端設定合理的 session 逾時;前端通知只是讓體驗更即時。
3. keepalive 有 body 大小限制(各家瀏覽器約 64KB),只適合送小型資料。
4. 若使用 beforeunload 只是為了攔問「確定要離開嗎」,那屬於另一個主題,且現在必須搭配使用者互動才有機會觸發。