「Web 调试技术|青训营笔记」

67 阅读5分钟

这是我参与「第五届青训营 」伴学笔记创作活动的第 22 天

今日内容:

  • 前端 Debug 的特点
  • Chrome DevTools
  • 移动端 H5 调试
  • NodeJs 调试
  • 常用开发调试技巧

前端 Debug 的特点

  1. 多平台

    • 浏览器、Hybrid、NodeJS、小程序、桌面应用等
  2. 多环境

    • 本地开发环境、线上环境
  3. 多工具

    • Chrome devTools、Charles、Spy-Debugger、Whistle、vConsle ...
  4. 多技巧

    • Console、BreakPoint、sourceMap、代理等

Chrome DevTools

动态修改元素和样式

  • 点击 .cls 开启动态修改元素的 class

  • 输入字符串可以动态的给元素添加类名

  • 勾选/取消类名可以动态的查看类名生效效果

  • 点击具体的样式值(字号、颜色、宽度高度等)可以进行编辑,浏览器内容区域实时预览

  • Computer 下点击样式里的箭头可以跳转到 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

Sorce Tab.png

区域1:页面资源文件目录树

区域2:代码预览区域

区域2:Debug 工具栏 从左到右依次为

  • 暂停(继续)
  • 单步跳过
  • 进入函数
  • 跳出函数
  • 单步执行
  • 激活(关闭)所有断点
  • 代码执行异常处自动

区域4:断点调试器

Break Point 与 Watch

  • 使用关键字 debugger 或 代码预览区域的行号可以设置断点
  • 执行到断点处是代码暂停执行
  • 展开 Breakpoints 列表可以查看断点列表,勾选/取消可以激活/禁用对应断点
  • 暂停状态下,鼠标 hover 变量可以查看变量的值
  • 在调试器 Watch 右侧点击 + 可以添加对变量的健康,查看该变量的值

Scope 与 Call Stack

压缩后的代码如何调试

前端代码天生具有“开源”属性,出于安全考虑,上线之前 JavaScript 代码通常会被压缩,压缩后的代码只有一行,变量使用 ‘a’、‘b’ 等替换,整体变得不可阅读。

Sourse Map

mappings 字段存储了源文件和 Source Map 的映射

  • 英文,表示源码及压缩代码的位置关联
  • 逗号,分隔一行代码中的内容
  • 分号,代表换行

映射见:Base64 VLQ codec (coder/decoder) and Sourcemap V3 mappings parser (murzwin.com)

NetWork

NetWork.png

区域1:控制面板

区域2:过滤面板

区域3:概览区域

区域4:Request Table 面板

区域5:总结面板

区域6:请求详情面板

Application

Application.png

Application 面板展示与本地存储相关的信息

  • Local Storage
  • Session Storage
  • IndexedDB
  • Web SQL
  • Cookie

Performance

Performance.png

区域1:控制面板

区域2:概览面板

  • FPS:每秒帧数
  • CPU:处理各个任务花费的时间
  • NET:各个请求花费时间

区域3:线程面板

  • Frames:帧线程
  • Main:主线程,负责执行Javascript,解析HTML/CSS,完成绘制
  • Raster:Raster线程,负责完成某个layer或者某些块(tile)的绘制。

区域4:统计面板

Lighthouse

Lighthouse.png

核心 Web 指标

Largest Contentful Paint (LCP):最大内容绘制,测量加载性能。为了提供良好的用户体验,LCP 应在页面首次开始加载后的 2.5 秒内发生。

First Input Delay(FID):首次输入延迟,测量交互性。伪类提供良好的用户体验,页面的 FID 应为 100 毫秒或更短。

Cumulative Layout Shift(CLS):累积布局偏移,测量视觉稳定性。为了提供良好的用户体验,页面的 CLS 应保持在 0.1 或更少。

移动端 H5 调试

真机调试

IOS

  1. 使用 Lightning 数据线将 iPhone 与 Mac 相连
  2. iPhone 开启 Web 检查器(设置 -> Safari -> 高级 -> 开启 Web 检查器)
  3. iPhone 使用 Safari 浏览器打开要调试的页面
  4. Mac 打开 Safari 浏览器调试(菜单栏 -> 开发 -> iPhone 设备名 -> 选择调试页面)
  5. 在弹出的 Safari Devwloper Tools 中调试

没有 iPhone 设备可以在 Mac App Store 安装 Xcode 使用其内置的 IOS 模拟器

Android

  1. 使用 USB 数据线将手机与电脑相连
  2. 手机进入开发者模式,勾选 USB 调试,并允许调试
  3. 电脑打开 Chrome 浏览器,在地址栏输入:chrome://inspect/#devices 并勾选 Discover USB devices 选项
  4. 手机允许远程调试,并访问调试页面
  5. 电脑点击 inspect 按钮
  6. 进入调试界面

VConsole

  • 日志(Logs):console.log|info|error|..
  • 网络(Network):XMLHttpRequest,Fetch,sendBeacon
  • 节点(Element):HTML 节点树
  • 存储(Storage):Cookies,LocalStorage,SessionStorage
  • 手动执行 JS 命令行
  • 自定义插件

使用代理工具调试

原理:

  • 电脑作为代理服务器
  • 手机通过 HTTP 代理连接到电脑
  • 手机上的请求都经过代理服务器

以 Charles 为例:

  1. 安装 Charles
  2. 查看电脑 IP 和 端口
  3. 将 IP、端口号填入手机 HTTP 代理
  4. Charles 允许授权
  5. 使用 SwitchHosts!软件给 Mac 电脑配 Hosts
  6. 手机访问开发环境页面

默认情况下,Charles 无法抓取到 HTTPS 的请求,需要安装证书。

NodeJS调试

Inspector Protocol + Chrome Devtool

  1. 执行命令 node --inspect=8888 index.js
  2. chrome 浏览器访问服务
  3. 点击绿色 node 图标 打开 node 调试面板(在 chrome://inspect/#devices 中配置network target)
  4. 在 node 调试面板中使用断点调试

Inspector Prorocol + VS code

VS Code 点击运行

添加配置

启动调试

添加断点

查看变量、堆栈

常用开发调试技巧

线上即时修改 Overrides

  1. 打开 Sources 面板下的 Overrides
  2. 点击 Select folders for Overrides。选择一个本地的空文件夹目录。
  3. 允许授权
  4. 在 page 中修改代码,修改完成后 command + s 保存
  5. 打开 devTools,点击右上角的三个小点 -> More tools -> Changes,就能看到所有修改了

启用本地 source map

线上不存在 Source Map 时可以使用 Map Local 网络映射功能来访问本地的 Source Map 文件。