最近公司做了一款接入百度錢包的手機網頁支付產品。使用情境是這樣的:使用者用百度錢包掃描我們產品上的二維碼進入頁面,挑好商品按下購買,我們的後台建立訂單並把支付資訊送給百度錢包;付款完成後,頁面理應自動關 ourselves 掉,回到原本的操作流。
問題在 Android 上一切正常,iOS 卻怎麼都關不掉。窗口一直停在支付完成的畫面上,使用者只能自己按返回,體驗打了折扣。
向百度錢包的技術支援詢問後才弄清楚:iOS 端必須先在 document 上派發一個 runtimeready 事件。百度錢包的 SDK JS 注入成功後會觸發這個事件,只有在事件觸發之後,才能安全地調用關閉窗口的動作。也就是說,我們原本的程式碼在 iOS 上執行時,SDK 往往還沒準備好,呼叫自然落空。
先判斷是否為 iOS 裝置,若是則建立並派發 runtimeready 事件,再註冊監聽,在回呼中關閉視窗;其他平台維持原本的呼叫方式即可。
var ua = navigator.userAgent.toLowerCase();
// 判斷是否為 iOS 裝置,其他裝置直接呼叫 BLightApp.closeWindow() 關閉
if (ua.indexOf("apple") != -1 || ua.indexOf("mac") != -1 || ua.indexOf("iphone") != -1) {
var event = document.createEvent('Events');
event.initEvent('runtimeready', false, false);
document.dispatchEvent(event);
document.addEventListener("runtimeready", function (e) {
BLightApp.closeWindow();
}, false);
} else {
BLightApp.closeWindow();
}
把這段邏輯放到多台 iPhone 上實測,包含不同機型與系統版本,頁面都能正常關閉,問題算是徹底解決。
這類問題的共通點是:跨端的 JS Bridge 往往有「何時才真正可用」的隱性時序,Android 較寬鬆,iOS 則要求開發者明確等待就緒訊號。往後接其他家支付或容器 SDK 時,先確認有沒有類似的 ready 事件,能少走很多彎路。