目录

跳转到的目标页面为空白页

问题现象

用户在应用内点击某个功能,发生页面跳转,跳转到的目标页面为空白页。

背景知识

问题定位

使用DevTools录制页面加载情况。

可看到网页加载时的地址出现ERR_NAME_NOT_RESOLVED错误(域名无法解析),IP地址不正确,资源请求超时。

分析结论

应用跳转的页面是加载的一个Web页面,由于该页面实际已经不存在,导致Web组件无法加载,出现白屏现象。

修改建议

  1. 检查Web网页的地址是否正确,如果不正确更换为正确的Web页面地址。
  2. 在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;
                }
              }
            });
        };
      }
    }