任何做过 Web 开发的同学,都避免不了在浏览器内进行调试。而大部分同学的首选工具,就是 Chrome DevTools。DevTools 本身我们无需多说,是一个大家不能再熟悉的工具了。但是埋藏在 DevTools 下面的开放协议以及它赋予的众多可能性,至今仍未见到充分的剖析和应用。
Webkit 的远程调试协议是 Webkit 在 2012 年引入的。目前所有 Webkit 内核的浏览器都支持这一特性。但是我们还是以 DevTools 和 Chrome 为出发点,来做讨论。
为什么我们关注 DevTools:
DevTools 的源码就在 Google 的 blink 项目 中,高度的开放。目前这么多丰富的功能,正是 Google 和其社区的共同贡献。同时它的 License 也不拒绝任何的二次开发。
DevTools 仅仅是简单的由 HTML、JavaScript、CSS、Images 组成的,本质上就是一个 WebApp,纯粹的前端应用。当你去了解、修改它时,你不需要理解 C++ 和任何编译的知识。
事实上 Devtools 是一个充分模块化的 JavaScript 网页应用。它的每个功能你都可以去扩展(仅需要了解 JavaScript)。
谈到远程调试前,有必要先了解各组件之间的关系。
DevTools 的界面是数据驱动的。数据的来源就是 WebSocket API。Google 对 Webkit 的调试协议做了进一步的封装,提供了以 JSON 为序列化格式的 WebSocket 界面。
大家在本地电脑上就可以体验这个远程调试是怎样一回事。执行如下步骤:
--remote-debugging-port=9222
,例如 Mac 平台:
open -a Google\ Chrome --args --remote-debugging-port=9222
注意看地址栏,我们访问的是一个标准的 HTTP 协议下的网页,不是 Chrome 的私有协议。这里,你可以用 DevTools 再次检视这个页面,即按下 CMD
+ OPTION
+ i
。你会发现,这真的就是一个 HTML 应用。
再观察一下这个 URL:
通过 QueryString,我们告诉了 DevTools 的前端应用,它应该连接到哪个 WebSocket 服务。
你可以再你刚打开的检视 DevTools 的 DevTools(好绕口)里面,观察整个调试过程中的 WebSocket 通讯。例如:
以前用 WebSocket 做过 RPC 的同学应该看得出来,Google 实现的的确就是一个远程调用的接口。这个接口里面有两种通讯模式:
通过调试协议来获取页面加载的所有网络请求并打印。为了简单,我们编写一个 Node.js 的应用来实现。大致步骤如下:
Network.requestWillBeSent
、Network.loadingFailed
、Network.loadingFinished
、 Network.responseReceived
、Network.requestServedFromCache 的 Notification
,并且打印相关的 log。Page.navigate
的请求,将页面跳转到某个页面,例如:http://www.taobao.com/这里拿到的数据足以绘制一个非常准确的页面加载的瀑布图。从调试协议里拿到的数据具有以下特点:
完整代码如下(请先安装好相应的 npm 模块,并且打开 Chrome 本地的 9222 调试端口):
var WebSocketClient = require("websocket").client,
util = require("util"),
EE = require("events").EventEmitter,
request = require("request"),
chalk = require("chalk"),
exec = require("child_process").exec;
// `Commander` class is message handler that talks to debug service exposed by Chrome
var Commander = function(conn) {
EE.call(this);
this.connection = conn;
this.sendCommands = [];
var self = this;
Object.defineProperty(this, "nextMsgId", {
get: function() {
return self.sendCommands.length;
},
enumerable: true,
configurable: false
});
conn.on("message", this.onMessage.bind(this));
};
util.inherits(Commander, EE);
// Send message using websocket connection
Commander.prototype.send = function(method, params, callback) {
this.sendCommands.push([method, params, callback]);
var msg = JSON.stringify({
id: this.nextMsgId,
method: method,
params: params
});
console.log(msg);
this.connection.send(msg);
};
//handler for receiving a message
Commander.prototype.onMessage = function(msg) {
var command, data;
if(msg.type === "utf8") {
data = JSON.parse(msg.utf8Data);
if(data.id) {//it's method request/response invocation
command = this.sendCommands[data.id-1];
if(command) {
if(command.callback) {
command.callback(data.params);
}
} else {
console.warn("unmatched message id %s", data.id);
}
} else {//notifications
this.emit(data.method, data.params);
}
} else {
console.warn("message of unknown encoding");
}
};
//find tab info
request("http://localhost:9222/json", function(e, res, data) {
data = JSON.parse(data);
var url = data[0].webSocketDebuggerUrl;
if(!url) {
throw new Error("no url");
}
var client = new WebSocketClient();
//once it's connect, start our actions
client.on("connect", function(conn) {
console.log("client connceted");
var commander = new Commander(conn);
//Shoud enable this freatures
commander.send("Network.enable",{});
commander.send("Page.enable",{});
//Listen to wanted notifications
commander.on("Network.requestWillBeSent", function(data) {
console.log("[%s] %s %s: %s", chalk.green(data.timestamp), chalk.blue("WillSend"), data.requestId, data.request.url);
});
commander.on("Network.loadingFailed", function(data) {
console.log("[%s] %s %s", chalk.green(data.timestamp), chalk.red("LoadFail"), data.requestId);
});
commander.on("Network.loadingFinished", function(data) {
console.log("[%s] %s %s", chalk.green(data.timestamp), chalk.magenta("LoadDone"), data.requestId);
});
commander.on("Network.responseReceived", function(data) {
console.log("[%s] %s %s: %s Status %s %s", chalk.cyan(data.timestamp), chalk.red("RespRecv"), data.requestId, data.type, data.response.status, data.response.headers["Content-Length"]);
});
commander.on("Network.requestServedFromCache", function(data) {
console.log("%s %s", chalk.gray(data.timestamp), chalk.red("RespCache"), data.requestId);
});
commander.on("Page.domContentEventFired", function() {
console.log(chalk.bgGreen("OnDOMContentLoad\t\t\t\t\t\t\t\t"));
});
commander.on("Page.loadEventFired", function() {
console.log(chalk.bgCyan("OnLoad\t\t\t\t\t\t\t\t"));
});
//Navigate to target page
commander.send("Page.navigate", {url: "http://www.taobao.com"});
});
client.connect(url);
});
运行后的结果如下:
本篇内容仅仅介绍调试协议这个概念,以及它的通讯原理。并且,我们通过一个实验,来展示这套协议的强大特性。后面,我们还会讨论其他浏览器的调试协议,以及移动设备的调试。
← 记一次淘宝首页奇葩的渲染问题 yield 和 yield* →