前言
以往,PageSpy 在线调试解决了很多棘手的问题,但使用 PageSpy 有个前提条件:「客户端和调试端必须同时在线」。这个前置条件不仅局限了 PageSpy 的使用场景,比如:
同时也给 PageSpy 自身带来边边框框,比如:
为了解决这些问题、使用时获得更大自由度,PageSpy 在 1.7.3 版本中提供了日志回放的功能!
日志回放
顾名思义是重新播放之前产生的日志。那么之前的日志从哪来?又该如何重新播放?我们一一来看。
在 PageSpy 的 SDK 支持 注册插件 后,开发团队第一时间推进 DataHarborPlugin 插件的研发。
DataHarborPlugin,数据港口插件
心智模型:PageSpy 产生的数据会源源不断的被送到 “数据港口”,在对数据进行打包、压缩后,“数据港口” 将数据整理存放在 “集装箱”(indexedDB 或者内存)中,等待下一步指示。
DataHarborPlugin 在内部监听 "public-data" 事件(什么是 public-data 事件?),进而对 PageSpy 产生的数据进行整理、压缩,实现离线缓存数据的功能。同时在 SDK 渲染的控件中提供了下载按钮,当客户端发现问题时,测试同学可以直接点击按钮导出数据,这一创新打破了以往「客户端和调试端必须同时在线」的前提要求:
之前:
现在:
DataHarborPlugin 默认将数据存储在 indexedDB 中,且不限制缓存数据的数量,这些行为都可在初始化插件时进行配置。更多详细信息请前往 DataHarborPlugin 主页查看。
如何使用日志回放
DataHarborPlugin 当前可用于客户端运行在浏览器环境中的场景。
第一步:客户端引入 SDK 和插件
引入后,SDK 渲染的控件弹窗里会有 “下载日志数据” 的按钮,点击后会自动下载以日期时间格式命名的 json 文件:
同时可以打开浏览器控制台查看 Application - Storage - indexedDB 菜单下是否有 __PUBLIC__page-spy 的 database:
第二步:回放日志
进入调试端的房间列表页面,点击日志回放,选择客户端下载的 json 文件。
第三步
进入日志回放面板后,左侧显示客户端的操作轨迹(需要接入 @huolala-tech/page-spy-plugin-rrweb 插件),右侧显示客户端的运行时信息。
总结
PageSpy 在 1.7.3 版本中推出了日志回放的功能,使用前需要接入 DataHarborPlugin 插件,同时我们还可以录制用户的操作轨迹(需要接入 RRWebPlugin 插件)。日志回访的功能打破了以往调试的「客户端和调试端必须同时在线」前置性条件!
我们相信 PageSpy 的本次更新将有力的推动高效协同、远程调试继续往前迈出一大步!
最后希望大家能够帮助 PageSpy 在仓库中点个 Star ,将 PageSpy 转发给身边的同事、朋友,感谢!
PageSpy 仓库地址: https://github.com/HuolalaTech/page-spy-web ;
日志回放介绍: https://github.com/HuolalaTech/page-spy-web/wiki/日志回放;