onReceiveError是WebViewClient提供的方法窥翩，用于網(wǎng)頁(yè)產(chǎn)生錯(cuò)誤時(shí)進(jìn)行回調(diào)處理田炭。
1. 舊版的onReceiveError
在API23之前鸭叙，該方法的簽名是：
public void onReceivedError(WebView view, int errorCode,String description, String failingUrl);
文檔是：
Report an error to the host application. These errors are unrecoverable (i.e. the main resource is unavailable). The errorCode parameter corresponds to one of the ERROR_* constants.
簡(jiǎn)單來(lái)說(shuō)韧骗，onReceivedError只有在遇到不可用的(unrecoverable)錯(cuò)誤時(shí)喉酌，才會(huì)被調(diào)用）愤兵。
比如鹿霸，當(dāng)WebView加載鏈接www.barryzhang.com時(shí)，"不可用"的情況有可以包括有：
- 沒(méi)有網(wǎng)絡(luò)連接
- 連接超時(shí)
- 找不到頁(yè)面www.barryzhang.com
而下面的情況則不會(huì)被報(bào)告：
- 網(wǎng)頁(yè)內(nèi)引用其他資源加載錯(cuò)誤秆乳，比如圖片懦鼠、css不可用
- js執(zhí)行錯(cuò)誤
2. 應(yīng)用：顯示個(gè)自定義ERROR界面
基于以上特性，所以它可以用來(lái)處理網(wǎng)頁(yè)加載不出來(lái)的情況屹堰，比如顯示一段友好的提示語(yǔ)肛冶、一個(gè)重試按鈕等。
比如像這樣：
@Override
public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {
super.onReceivedError(view, errorCode, description, failingUrl);
layoutError.setVisibility(View.VISIBLE);
textViewErrorMessage.setText("(錯(cuò)誤碼:" + errorCode + " " + description + ")" );
}
——這么做的還有一個(gè)原因是扯键，雖然默認(rèn)的網(wǎng)頁(yè)錯(cuò)誤樣式每個(gè)ROM都可能不一樣睦袖，但是卻是一樣的丑……，來(lái)個(gè)對(duì)比圖感受一下荣刑，從左到右依次是：MIUI(Android5.0.2)馅笙、Nexus5X(Android7)、以及自定義之后的效果：
3. 新版的onReceiveError
So far so good, but~
API23(Android6)厉亏，Google對(duì)onReceiveError進(jìn)行了一次改版重載董习，并且把老版本的廢棄了，ㄒoㄒ~~
簽名改成了這樣：
public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error);
文檔改成了：
Report web resource loading error to the host application. These errors usually indicate inability to connect to the server. Note that unlike the deprecated version of the callback,the new version will be called for any resource (iframe, image, etc), not just for the main page. Thus, it is recommended to perform minimum required work in this callback.
新版的onReceiveError能接收到的錯(cuò)誤更多爱只，不再局限于之前的"不可用"的情況——好像是比之前更強(qiáng)大了皿淋。
但是，這時(shí)候如果我們依然用使用舊版本的方式來(lái)使用新版，像這樣：
@Override
public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
// Ｎ讶ぁ疯暑！在新版的onReceivedError中，沿用之前的處理邏輯（這是錯(cuò)誤的示例Ｑ剖妗８菊）
super.onReceivedError(view, errorCode, description, failingUrl);
layoutError.setVisibility(View.VISIBLE);
textViewErrorMessage.setText("(錯(cuò)誤碼:" + error.getErrorCode() + " " + error.getDescription().toString() + ")" );
}
這會(huì)導(dǎo)致的問(wèn)題是：在Android6以上的機(jī)器上，網(wǎng)頁(yè)中的任意一個(gè)資源獲取不到（比如字體）散址，網(wǎng)頁(yè)就很可能顯示自定義的錯(cuò)誤界面乖阵。尤其是如果Html用了本地化技術(shù)，'ERR_FILE_NOT_FOUND'開(kāi)始變得特別常見(jiàn)预麸。
4. 如何像在老版本一樣工作？
4.1 繼續(xù)用老版本呢儒将？
Bingo吏祸！可以，起碼從目前來(lái)看钩蚊，測(cè)試結(jié)果表明至少在Andoid6以及Android7上是可以工作的贡翘。
然而，終究砰逻，使用已廢棄的API終究是不太優(yōu)雅——說(shuō)不定哪個(gè)版本就突然不能用了鸣驱，仿佛像個(gè)定時(shí)炸彈一樣。
4.2 isForMainFrame
我們注意到新版的onReceivedError跟老版相比蝠咆，多了一個(gè)WebResourceRequest參數(shù)踊东，而WebResourceRequest有一個(gè)方法叫做isForMainFrame，描述為：
Gets whether the request was made for the main frame
獲取當(dāng)前的網(wǎng)絡(luò)請(qǐng)求是否是為main frame創(chuàng)建的.
加上這個(gè)條件判斷是來(lái)試試刚操？
@Override
public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
super.onReceivedError(view, errorCode, description, failingUrl);
if(request.isForMainFrame()){// 在這里加上個(gè)判斷
// 顯示錯(cuò)誤界面
}
}
實(shí)驗(yàn)證明這個(gè)方法是有效的闸翅。
4.3 當(dāng)然,也還有其他方法
可以這樣，直接上代碼：
@Override
public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
super.onReceivedError(view, errorCode, description, failingUrl);
if (request.getUrl().toString() .equals(getUrl())) {// 在這里加上個(gè)判斷
// 顯示錯(cuò)誤界面
}
}
原理是：用請(qǐng)求的url來(lái)判斷菊霜，如果出錯(cuò)的url跟webView當(dāng)前加載的url一致坚冀，就顯示錯(cuò)誤頁(yè)面。
↑↑經(jīng)測(cè)試鉴逞，也能通過(guò)~
總結(jié)
總而言之记某，最終的代碼這樣寫，可以同時(shí)兼容新舊版本：
// 舊版本构捡，會(huì)在新版本中也可能被調(diào)用液南，所以加上一個(gè)判斷，防止重復(fù)顯示
@Override
public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {
super.onReceivedError(view, errorCode, description, failingUrl);
if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.M){
return;
}
// 在這里顯示自定義錯(cuò)誤頁(yè)
}
// 新版本叭喜，只會(huì)在Android6及以上調(diào)用
@TargetApi(Build.VERSION_CODES.M)
@Override
public void onReceivedError(WebView view, WebResourceRequest request, WebResourceError error) {
super.onReceivedError(view, request, error);
if (request.isForMainFrame()){ // 或者： if(request.getUrl().toString() .equals(getUrl()))
// 在這里顯示自定義錯(cuò)誤頁(yè)
}
}
Also in：
http://www.barryzhang.com/
https://barryhappy.github.io/
