目录

Web组件加载网络链接失败后如何加载错误页面

问题现象

如果网络或者在线链接有问题时,Web组件加载网络链接会失败,此时如何加载本地缺省页面(指定失败页面)并进行页面刷新?

效果预览

背景知识

解决方案

常见FAQ

Q:为什么加载视频的网页一直触发onErrorReceive?

A:在onErrorReceive回调中,查看getErrorCode获取的错误码为-2。-2表示ERR_FAILED,是一个通用的错误代码,表明产生了一般性的错误。错误产生与多种原因有关,可以表示网络错误、文件传输失败、协议栈错误等。接着分析网页的网络请求,发现网页发出了多个请求,而多个响应的HTTP状态码为206。

HTTP的206状态码用于表示服务器已成功处理部分Get请求,常见于视频加载和文件下载,尤其是断点续传场景。从错误码和状态码验证可知,一直触发onErrorReceive的原因是,网页中请求了视频资源,而视频使用了断点续传技术,就会导致资源请求多次。因为每一次只处理部分请求,没有完成整个文件的传输,就会引起onErrorReceive回调一次或者多次。

总结

可以根据缺省页面的实现形式选择实现方案:

缺省页面的实现形式

方案的主要实现方法

优点

缺点

ArkTS页面

onErrorReceive回调+visibility控件显示状态。

加载速度极快,ArkTS渲染,无加载延迟。

需要编写缺省页ArkTS页面布局。

html页面

onErrorReceive回调+loadUrl加载本地html页面。

可模块化管理,便于调试,可复用其他端html页面。

需要将html文件放在资源目录下,需要文件系统IO,首次加载有延迟。

html格式的文本数据

方案一: onErrorReceive回调+loadData加载html格式的文本数据。

从内存解析,启动瞬间完成。

复杂页面难以维护,全部写成字符串很臃肿。

html格式的文本数据

方案二:setErrorPageEnabled+onOverrideErrorPage回调中添加html格式的字符串。

系统自定义页面,可以直接将html内容渲染在页面上,用户体验感相对于loadData更好。

复杂页面难以维护,全部写成字符串很臃肿。