Chrome Devtools 高级调试指南(新)

本文暂未涉及 Performance 面板的内容。

后续会单独出一篇,以下是目录:

  1. 常用命令和调试

  2. 黑盒脚本: Blackbox Script

  3. 控制台内置指令

  4. 远程调试 WebView

1. Chrome Devtools 的用处

  • 前端开发:开发预览、远程调试、性能调优、 bug 跟踪、断点调试等

  • 后端开发:网络抓包、开发调试Response

  • 测试:服务端 API 数据是否正确、审查页面元素样式及布局、页面加载性能分析、自动化测试

  • 其他:安装扩展插件,如 AdBlock、Gliffy、Axure

2. 菜单面板拆解

  • Elements – 页面dom元素

  • Console – 控制台

  • Sources – 页面静态资源

  • Network – 网络

  • Performance – 设备加载性能分析

  • Application – 应用信息, PWA/Storage/Cache/Frames

  • Security – 安全分析

  • Audits – 审计,自动化测试工具

3. 常用命令和调试

1. 呼出快捷指令面板:cmd + shift + p

Devtools 打开的情况下,键入 cmd + shift + p 将其激活,然后开始在栏中键入要查找的命令或输入 "?" 号以查看所有可用命令。

  • : 打开文件

  • : : 前往文件

  • @ :前往标识符(函数,类名等)

  • ! : 运行脚本文件

  • >; : 打开某菜单功能

1.性能监视器:> performance monitor

将显示性能监视器以及相关信息,例如CPU,JS堆大小和DOM节点。

2.FPS实时监控性能:> FPS选择第一项

3.截图单个元素:> screen 选择 Capture node screenhot

2. DOM 断点调试

当你要调试特定元素的DOM中的更改时,可以使用此选项。这些是DOM更改断点的类型:

  • Subtree modifications : 子节点删除或添加时

  • Attributes modifications : 属性修改时

  • Node Removal : 节点删除时

如上图:监听form标签,在input框获得焦点时,触发断点调试

3. 黑盒脚本:Blackbox Script

剔除多余脚本断点。

例如第三方( Javascript 框架和库,广告等的堆栈跟踪)。

为避免这种情况并集中精力处理核心代码,在 Sources 或网络选项卡中打开文件,右键单击并选择 Blackbox Script

4. 事件监听器:Event Listener Breakpoints

  1. 点击 Sources 面板

  2. 展开 Event Listener Breakpoints

  3. 选择监听事件类别,触发事件启用断点

如上图:
监听了键盘输入事件,就会跳到断点处。

5. 本地覆盖:Local overrides

使用我们自己的本地资源覆盖网页所使用的资源。

类似的,使用 DevTools 的工作区设置持久化,将本地的文件夹映射到网络,在 chrome 开发者功能里面对css 样式的修改,都会直接改动本地文件,页面重新加载,使用的资源也是本地资源,达到持久化的效果。

  • 创建一个文件夹以在本地添加替代内容;

  • 打开 Sources >; Overrides >; Enable local Overrides ,选择本地文件夹

  • 打开 Elements ,编辑样式,自动生成本地文件。

  • 返回 Sources ,检查文件,编辑更改。

6. 扩展:Local overrides 模拟 Mock 数据

来自:chrome 开发者工具 – local overrides

对于返回json 数据的接口,可以利用该功能,简单模拟返回数据。

比如:

  • api 为: http://www.xxx.com/api/v1/list

  • 在根目录下,新建文件 www.xxx.com/api/v1/listlist 文件中的内容,与正常接口返回格式相同。

对象或者数组类型,从而覆盖掉原接口请求。

4. 控制台内置指令

可以执行常见任务的功能,例如选择 DOM 元素,触发事件,监视事件,在 DOM 中添加和删除元素等。

这像是 Chrome 自身实现的 jquery 加强版。

1. $(selector, [startNode]):单选择器

document.querySelector 的简写

语法:

$('a').href;
$('[test-id="logo-img"]').src;
$('#movie_player').click();

控制台还会预先查询对应的标签,十分贴心。

还可以触发事件,如暂停播放:

此函数还支持第二个参数startNode,该参数指定从中搜索元素的“元素”或Node。此参数的默认值为document

2. $$(选择器,[startNode]):全选择器

document.querySelectorAll 的简写,返回一个数组标签元素

语法:

$$('.button')

可以用过循环实现切换全选

或者打印属性

此函数还支持第二个参数startNode,该参数指定从中搜索元素的“元素”或Node。此参数的默认值为document

用法:

var images = $$('img', document.querySelector('.devsite-header-background'));
   for (each in images) {
       console.log(images[each].src);
}

3. $x(path, [startNode]):xpath选择器

$x(path) 返回与给定 xpath 表达式匹配的DOM元素数组。

例如,以下代码返回

页面上的所有元素:

$x("//p")

以下代码返回

包含

元素的所有元素:

$x("//p[a]")

xpath 多用于爬虫抓取,前端的同学可能不熟悉。

4. getEventListeners(object):获取指定对象的绑定事件

getEventListeners(object) 返回在指定对象上注册的事件侦听器。返回值是一个对象,其中包含每个已注册事件类型(例如, clickkeydown )的数组。每个数组的成员是描述为每种类型注册的侦听器的对象。

用法:

getEventListeners(document);

相对于到监听面板里查事件,这个
API

便捷多了。

5. 花式console

除了不同等级的 warnerror 打印外

还有其它非常实用的打印。

1. 变量打印:%s、%o、%d、和%c

const text = "文本1"
console.log(`打印${text}`)

除了标准的 ES6 语法,实际上还支持四种字符串输出。

分别是:

console.log("打印 %s", text)
  • %s :字符串

  • %o :对象

  • %d :数字或小数

还有比较特殊的 %c ,可用于改写输出样式。

console.log('%c 文本1', 'font-size:50px; background: ; text-shadow: 10px 10px 10px blue')

当然,你也可以结合其它一起用(注意占位的顺序)。

const text = "文本1"
console.log('%c %s', 'font-size:50px; background: ; text-shadow: 10px 10px 10px blue', text)

你还可以这么玩:

console.log('%c Auth ', 
            'color: white; background-color: #2274A5', 
            'Login page rendered');
console.log('%c GraphQL ', 
            'color: white; background-color: #95B46A', 
            'Get user details');
console.log('%c Error ', 
            'color: white; background-color: #D33F49', 
            'Error getting user details');

2. 打印对象的小技巧

当我们需要打印多个对象时,经常一个个输出。且看不到对象名称,不利于阅读:

以前我的做法是这么打印:

console.log('hello', hello);
console.log('world', world);

这显然有点笨拙繁琐。其实,输出也支持对象解构:

console.log({hello, world});

3. 布尔断言打印:console.assert()

当你需要在特定条件判断时打印日志,这将非常有用。

  • 如果断言为false,则将一个错误消息写入控制台。

  • 如果断言是true,没有任何反应。

语法

console.assert(assertion,obj)

用法

const value = 1001
console.assert(value===1000,"value is not 1000")

4. 给console 编组:console.group()

当你需要将详细信息分组或嵌套在一起以便能够轻松阅读日志时,可以使用此功能。

console.group('用户列表');
console.log('name: 张三');
console.log('job: :dog:前端');
// 内层
console.group('地址');
console.log('Street: 123 街');
console.log('City: 北京');
console.log('State: 在职');
console.groupEnd(); // 结束内层
console.groupEnd(); // 结束外层

5. 测试执行效率:console.time()

没有 Performance API 精准,但胜在使用简便。

let i = 0;
console.time("While loop");
while (i < 1000000) {
  i++;
}
console.timeEnd("While loop");
console.time("For loop");
for (i = 0; i < 1000000; i++) {
  // For Loop
}
console.timeEnd("For loop");

6. 输出表格:console.table()

这个适用于打印数组对象。。。

let languages = [
    { name: "JavaScript", fileExtension: ".js" },
    { name: "TypeScript", fileExtension: ".ts" },
    { name: "CoffeeScript", fileExtension: ".coffee" }
];
console.table(languages);

7. 打印DOM 对象节点:console.dir()

打印出该对象的所有属性和属性值.

console.dir()console.log() 的作用区别并不明显。若用于打印字符串,则输出一摸一样。

console.log("Why,hello!");
console.dir("Why,hello!");

在输出对象时也仅是显示不同( log 识别为字符串输出, dir 直接打印对象。)。

唯一显著区别在于打印 dom 对象上:

console.log(document)
console.dir(document)

一个打印出纯标签,另一个则是输出
DOM

树对象。

6. 远程调试WebView

使用 Chrome 开发者工具在原生 Android 应用中调试 WebView

  1. 配置 WebViews 进行调试。

    WebView 类上调用静态方法 setWebContentsDebuggingEnabled

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
        WebView.setWebContentsDebuggingEnabled(true);
    }
    
  2. 手机打开 usb 调试,插上电脑。

  3. Chrome 地址栏输入: Chrome://inspect

正常的话在
App 中打开
WebView 时,
chrome

中会监听到并显示你的页面。

  1. 点击页面下的 inspect ,就可以实时看到手机上 WebView 页面的显示状态了。(第一次使用可能会白屏,这是因为需要去 https://chrome-devtools-frontend.appspot.com 那边下载文件)

除了 inspect 标签,还有 Focus tab :

  • 它会自动触发 Android 设备上的相同操作

其他应用里的 WebView 也可以,例如这是某个应用里的游戏,用的也是网页:

参考资料

  1. Practical Chrome Devtools — Common commands & Debugging

  2. Mobile web specialist — Remote Debugging

  3. Console Utilities API Reference

  4. Console API Reference

:heart: 看完三件事

如果你觉得这篇内容对你挺有启发,我想邀请你帮我三个小忙:

  1. 点赞,让更多的人也能看到这篇内容(收藏不点赞,都是耍流氓 -_-)

  2. 关注公众号「前端劝退师」,不定期分享原创知识。

  3. 也看看其它文章

  • 120行代码实现一个交互完整的拖拽上传组件

  • 160行代码实现动态炫酷的可视化图表 – 排行榜

  • 「数据可视化库王者」D3.js 极速上手到Vue应用

  • 「真®全栈之路」Web前端开发的后端指南

  • 「Vue实践」5分钟撸一个Vue CLI 插件

  • 「Vue实践」武装你的前端项目

  • 「中高级前端面试」JavaScript手写代码无敌秘籍

  • 「从源码中学习」面试官都不知道的Vue题目答案

  • 「从源码中学习」Vue源码中的JS骚操作

  • 「Vue实践」项目升级vue-cli3的正确姿势

  • 为何你始终理解不了JavaScript作用域链?