问题现象
使用Web组件加载H5页面是当前应用开发的普遍做法,当用户打开应用中的某个H5页面时,资源未加载完成会有错误提示信息,如:JSBridge's initialization failed。
背景知识
- 前端页面调用应用侧函数:开发者使用Web组件将应用侧代码注册到前端页面中,注册完成之后,前端页面中使用注册的对象名称就可以调用应用侧的函数,实现在前端页面中调用应用侧方法。
- javaScriptProxy:将javaScriptProxy中的ArkTS对象注册到Web组件中,该对象将使用javaScriptProxy中指定的名称注册到网页的所有框架中,包括所有iframe,这使得javaScript可以调用javaScriptProxy中ArkTS对象的方法。当属性没有显式调用时,默认不将javaScriptProxy中的ArkTS对象注册到Web组件中。
问题定位
- 根据问题现象以及报错信息可以发现,是JSBridge未初始化导致的问题,导致代码中存在对应异常抛出,相关日志中也有对应的报错打印。
[CONSOLE:2] "Error: JSBridge's initialization failed", source: 示例网址 (2)
- 使用DevTools工具,在浏览器中查看页面的console控制台输出的日志,定位到引发错误的具体位置。
- 在该错误位置,找到相应的异常捕获代码,并通过捕获的关键词进行定位,以确定最终的错误原因。
分析结论
在打开页面时,JSBridge存在未初始化的数据,导致前端未获取到正确的url地址进行页面展示。
修改建议
确保在调用JSBridge相关方法之前,已经正确初始化JSBridge,并传递正确的参数,可参考前端页面调用应用侧函数流程。