问题现象
用户在应用内点击某个功能,发生页面跳转,跳转到的目标页面为空白页。
背景知识
- ArkWeb简介:ArkWeb(方舟Web)提供了Web组件,用于在应用程序中显示Web页面内容。
- DevTools:Web组件支持使用DevTools工具调试前端页面。DevTools是一个Web前端开发调试工具,提供了电脑上调试移动设备前端页面的能力。开发者通过setWebDebuggingAccess()接口开启Web组件前端页面调试能力,利用DevTools工具可以在电脑上调试移动设备上的前端网页,设备需为4.1.0及以上版本。更多详细内容可以看使用DevTools工具调试前端页面。
问题定位
使用DevTools录制页面加载情况。

可看到网页加载时的地址出现ERR_NAME_NOT_RESOLVED错误(域名无法解析),IP地址不正确,资源请求超时。
分析结论
应用跳转的页面是加载的一个Web页面,由于该页面实际已经不存在,导致Web组件无法加载,出现白屏现象。
修改建议
- 检查Web网页的地址是否正确,如果不正确更换为正确的Web页面地址。
- 在ArkWeb组件的生命周期中,通过onErrorReceive来检查网页是否存在加载错误,如果存在错误,可以在onPageEnd回调中加载一个默认页面用于提醒用户加载异常。
// xxx.ets
import { webview } from '@kit.ArkWeb';
import { BusinessError } from '@kit.BasicServicesKit';
@Entry
@Component
struct WebComponent {
isError: boolean = false;
controller: webview.WebviewController = new webview.WebviewController();
responseWeb: WebResourceResponse = new WebResourceResponse();
heads: Header[] = new Array();
webData: string = '<!DOCTYPE html>\n' +
'<html>\n' +
'<head>\n' +
'<title>intercept test</title>\n' +
'</head>\n' +
'<body>\n' +
'<h1>intercept test</h1>\n' +
'</body>\n' +
'</html>';
aboutToAppear(): void {
try {
webview.WebviewController.setWebDebuggingAccess(true);
} catch (error) {
console.error(`ErrorCode: ${(error as BusinessError).code}, Message: ${(error as BusinessError).message}`);
}
}
build() {
Column() {
// 请使用真实地址
Web({ src: '', controller: this.controller }).fileAccess(false).geolocationAccess(false)
.onControllerAttached(() => {
// 推荐在此loadUrl、设置自定义用户代理、注入JS对象等
console.info('onControllerAttached execute');
})
.onLoadIntercept((event) => {
if (event) {
}
// 返回true表示阻止此次加载,否则允许此次加载
return false;
})
.onOverrideUrlLoading((webResourceRequest: WebResourceRequest) => {
if (webResourceRequest && webResourceRequest.getRequestUrl() == 'about:blank') {
return true;
}
return false;
})
.onPageEnd((event) => {
// 推荐在此事件中执行JavaScript脚本
if (event) {
console.info('onPageEnd url:' + event.url);
}
if (this.isError) {
console.info('isError: ' + this.isError);
// 当页面加载出错时,给出提示信息或者可以根据业务需要跳转到相应页面。
this.controller.loadData(this.webData, 'text/html', 'UTF-8');
}
this.isError = false;
})
.onPageVisible((event) => {
console.info('onPageVisible url:' + event.url);
})
.onRenderExited((event) => {
if (event) {
console.info('onRenderExited reason:' + event.renderExitReason);
}
})
.onDisAppear(() => {
this.getUIContext().getPromptAction().showToast({
message: 'The web is hidden',
duration: 2000
});
})
.onErrorReceive((event) => {
if (event) {
console.info('onErrorReceive');
// 页面加载出错
if (event.request.isMainFrame()) {
this.isError = true;
}
}
});
};
}
}