前端开发调试
Bug 与 Debug
Bug 的产生
前端 Debug 的特点
-
多平台
浏览器、Hybrid、NodeJs、小程序、桌面应用等
-
多环境
本地开发环境、线上环境
-
多工具
Chrome devTools、Charles、Spy-Debugger、Whistle、vConsole...
-
多技巧
Console、BreakPoint、sourceMap、代理等
Chrome DevTools
动态修改元素和样式
- 点击 .cls 开启动态修改元素的 class
- 输入字符串可以动态的给元素添加类名
- 勾选/取消类名可以动态的查看类名生效效果
- 点击具体的样式值(字号、颜色、宽度高度等)可以进行编辑,浏览器内容区域实时预览
- Computed 下点击样式里的箭头可以跳转到 styles 面板中的 css 规则
可以用以下两种方式强制激活伪类:
- 选中具有伪类的元素,点击 :hov
- DOM 树右键菜单,选择 Force State
Console
-
console.log
-
console.warn
-
console.error
-
console.debug
-
console.info
-
console.table
- 具象化的展示 JSON 和数组数据
-
console.dir
- 通过类似文件树的方式展示对象的属性
-
占位符
- 给日志添加样式,可以突出重要的信息
- %s:字符串占位符;%o:对象占位符;%c:样式占位符;%d:数字占位符
左侧可以选择等级,对日志进行分类查看
Sorce Tab
区域1:页面资源文件目录树
区域2:代码预览区域
区域3:Debug 工具栏;从左到右依次为
- 暂停(继续)
- 单步跳过
- 进入函数
- 跳出函数
- 单步执行
- 激活(关闭)所有断点
- 代码执行异常处自动
区域4:断点调试器
Break Point 与 Watch
- 使用关键字 debugger 或代码预览区域的行号可以设置断点
- 执行到断点处时代码暂停执行
- 展开 Breakpoints 列表可以查看断点列表,勾选/取消可以激活/禁用对应断点
- 暂停状态下,鼠标 hover 变量可以查看变量的值
- 在调试器 Watch 右侧点击 + 可以添加对变量的监控,查看该变量的值
Scope 与 Call Stack
- 展开 Scope 可以查看作用域列表(包含闭包)
闭包可以参考:developer.mozilla.org/en-US/docs/…
- 展开 Call Stack 可以查看当前 JavaScript 代码的调用栈
关于调用栈可以参考:developer.mozilla.org/en-US/docs/…
压缩后的代码如何调试?
前端代码天生具有“开源”属性,出于安全考虑,上线之前 JavaScript 代码通常会被压缩,压缩后的代码只有一行,变量使用‘a’、‘b’等替换,整体变得不可阅读。那么压缩后的代码如何调试呢?
Source Map
mappings 字段存储了源文件和 Source Map 的映射
- 英文,表示源码及压缩代码的位置关联
- 逗号,分隔一行代码中的内容
- 分号,代表换行
映射见:www.murzwin.com/base64vlq.h…
source Map 标准:docs.google.com/document/d/…
NetWork
- 区域1:控制面板
- 区域2:过滤面板
- 区域3:概览区域
- 区域4:Request Table 面板
- 区域5:总结面板
- 区域6:请求详情面板
Application
Application 面板展示与本地存储相关的信息
- Local Storage
- Session Storage
- IndexedDB
- Web SQL
- Cookie
点击左侧 Application 下的 Stroage 面板中的 Clear Site Data 可以清楚网页的本地存储数据
Performance
-
区域1:控制面板
-
区域2:概览面板
- FPS:每秒帧数
- CPU:处理各个任务花费的时间
- NET:各个请求花费时间
-
区域3:线程面板
- Frames:帧线程
- Main:主线程,负责执行 JavaScript,解析 HTML/CSS,完成绘制
- Raster:Raster 线程,负责完成某个 layer 或者某些块(tile)的绘制
-
区域4:统计面板
Performance 运行示例
googlechrome.github.io/devtools-sa…
Lighthouse
核心 Web 指标
- Largest Contentful Paint(LCP):最大内容绘制,测量加载性能。为了提供良好的用户体验,LCP 应在页面首次开始加载后的2.5秒内发生
- First Input Delay(FID):首次输入延迟,测量交互性。为了提供良好的用户体验,页面的 FID 应为100毫秒或更短
- Cumulative Layout Shift(CLS):累积布局偏移,测量视觉稳定性。为了提供良好的用户体验,页面的 CLS 应保持在0.1或更少
移动端 H5 调试
真机调试
IOS:
- 使用 Lightning 数据线将 IPhone 与 Mac 相连
- IPhone 开启 Web 检查器(设置——→Safari——→高级——→开启 Web 检查器)
- IPhone 使用 Safari 浏览器打开要调试的页面
- Mac 打开 Safari 浏览器调试(菜单栏——→开发——→ Iphone 设备名——→选择调试页面)
- 在弹出的 Safari Developer Tools 中调试
没有 IPhone 设备可以在 Mac AppStore 安装 Xcode 使用其内置的 IOS 模拟器
Androud:
- 使用 USB 数据线将手机与电脑相连
- 手机进入开发者模式,勾选 USB 调试,并允许调试
- 电脑进入 Chrome 浏览器,在地址栏输入:chrome://inspect/#devices 并勾选 Discover USB devices 选项
- 手机允许远程调试,并访问调试页面
- 电脑点击 inspect 按钮
- 进入调试界面
直接使用手机扫码查看,体验更佳
VConsole
- 日志(Logs):console.log|info|error|...
- 网络(Network):XMLHttpRequest,Fetch,sendBeacon
- 节点(Element):HTML 节点树
- 存储(Storage):Cookies,LocalStorage,SessionStorage
- 手动执行 JS 命令行
- 自定义插件
使用代理工具调试
原理:
- 电脑作为代理服务器
- 手机通过 HTTP 代理连接到电脑
- 手机上的请求都经过代理服务器
以 Charles 为例:
- 安装 Charles
- 查看电脑 IP 和端口
- 将 IP、端口号填入手机 HTTP 代理
- Charles 允许授权
- 使用 SwitchHosts!软件给 Mac 电脑配 Hosts
- 手机访问开发环境页面
默认情况下,Charles 无法抓取到 HTTPS 的请求,需要安装证书
常见代理工具
NodeJs 调试
Inspector Protocol + Chrome Devtool
- 执行命令 node --inspect=8888 index.js
- chrome 浏览器访问服务
- 点击绿色 node 图标打开 node 调试面板(在 chrome://inspect/#devices 中配置 network target)
- 在 node 调试面板中使用断点调试
Inspector Protocol + VS Code
VS Code 点击运行
添加配置
启动调试
添加断点
查看变量、堆栈
常用开发调试技巧
线上即时修改 Overrides
- 打开 Sources 面板下的 Overrides
- 点击 Select folders for Overrides。选择一个本地的空文件夹目录
- 允许授权
- 在 page 中修改代码,修改完成后 command + s 保存
- 打开 devTools,点击右上角的三个小点——> More tools ——> Changes,就能看到所有修改了
利用代理解决开发阶段的跨域问题
启用本地 source map
线上不存在 Source Map 时可以使用 Map Local 网络映射功能来访问本地的 Source Map 文件
使用代理工具 Mock 数据
- 右键选中要 mock 数据的接口,选择 save response,保存文件到本地
- 本地打开保存的文件,编辑想 mock 的数据并保存
- 右键选中第一步的接口,选择 Map Local,Local Path 选择第二步的文件
小黄鸭调试大法
传说中程序大师随身携带一只小黄鸭,在调试代码的时候会在桌上放上这只小黄鸭,然后详细地向鸭子解释每行代码,然后很快就将问题定位修复了。 --《程序员修炼之道》