用 UIWebView 載入網頁時常會遇到這樣的需求:伺服器回傳異常(例如 404 找不到頁面、504 逾時),我們希望在原生端攔下來,改顯示自繪的圖片與文案,而不是讓使用者看到系統那張樸素的錯誤頁。問題是——要怎麼知道 webview 載入失敗了,失敗在哪一步?
webview 發出請求之後,唯一能觀察狀態的入口就是它的代理方法:
// 即將載入內容時呼叫,回傳 YES 才會繼續 - (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType; // 開始載入 - (void)webViewDidStartLoad:(UIWebView *)webView; // 載入完成 - (void)webViewDidFinishLoad:(UIWebView *)webView; // 載入過程出錯 - (void)webView:(UIWebView *)webView didFailLoadWithError:(nullable NSError *)error;
第一個嘗試的當然是 didFailLoadWithError:,但實測發現:請求到 404 頁面時,這個方法根本沒有被呼叫。
原因其實很合理。didFailLoadWithError: 處理的是載入過程本身出錯——DNS 解析失敗、連線逾時、憑證有問題這類情況。而 404 是一次「成功的 HTTP 交易」:伺服器好好地回了一個狀態碼 404 與一份 HTML 內容,網頁確實下載完成了,只是內容剛好是錯誤頁。既然載入成功,自然不會走失敗回呼。
既然 delegate 拿不到,那就自己想辦法取得 HTTP 回應。常見做法是重新發一次請求並取出 NSHTTPURLResponse 的 statusCode。但這裡有個坑:舊寫法用的 sendSynchronousRequest:returningResponse:error: 在 iOS 9 之後已被棄用,編譯時會出現警告。
'sendSynchronousRequest:returningResponse:error:' is deprecated: first deprecated in iOS 9.0 - Use [NSURLSession dataTaskWithRequest:completionHandler:]
改用 NSURLSession 之後還有一個關鍵細節:要在哪個 delegate 方法裡取值?
實測結果如下:
webViewDidStartLoad::拿到的狀態碼一律是 0。因為此時請求才剛發出,正在等伺服器回應,還沒有任何結果。shouldStartLoadWithRequest::可以拿到正確狀態碼。webViewDidFinishLoad::同樣可以拿到正確狀態碼。方法一:同步請求(僅適合簡單場景)
NSHTTPURLResponse *response = nil;
[NSURLConnection sendSynchronousRequest:request
returningResponse:&response
error:nil];
NSLog(@"statusCode:%ld", (long)response.statusCode);
方法二:NSURLSession(建議)
NSURLSessionDataTask *dataTask =
[[NSURLSession sharedSession] dataTaskWithRequest:webView.request
completionHandler:^(NSData * _Nullable data,
NSURLResponse * _Nullable response,
NSError * _Nullable error) {
NSHTTPURLResponse *tmpresponse = (NSHTTPURLResponse *)response;
NSLog(@"statusCode:%ld", (long)tmpresponse.statusCode);
}];
[dataTask resume];
兩種方式都能在 shouldStartLoadWithRequest: 與 webViewDidFinishLoad: 中取得狀態碼,究竟放哪一個,取決於業務需求:想攔在載入之前就不要渲染錯誤頁,放前者;想等頁面處理完再判斷,放後者。
不過要提醒的是,同步請求會阻塞當前執行緒,若寫在主線程的 delegate 方法裡,等於讓整個 UI 卡住等網路回應,正式專案請一律走非同步版本。
另外,若你的專案已全面改用 WKWebView,這個問題的處理方式會更直接:實作 WKNavigationDelegate 的 didReceiveResponse: 就能拿到 WKFrameResponse,判斷其中的 response 是否為 NSHTTPURLResponse 並檢查狀態碼,不必再自己多發一次請求。這也是新專案建議直接採用 WKWebView 的理由之一。