在 Chrome 开发者工具中调试 node.js
2017-03-04 20:33
756 查看
命令行工具 devtool ,它可以在 Chrome 的开发者工具中运行 Node.js 程序。
下面的记录显示了在一个 HTTP 服务器中设置断点的情况。
该工具基于 Electron 将 Node.js 和 Chromium 的功能融合在了一起。它的目的在于为调试、分析和开发 Node.js 应用程序提供一个简单的界面。
你可以使用 npm 来安装它:
在某种程度上,我们可以用它来作为
这将启动一个带有 Node.js 特性支持的 Chrome 开发者工具实例。
我们可以引用 Node 模块、本地 npm 模块和像
其他的例子就一目了然了:
这行命令将会在 Chrome 开发者工具中的控制台中启动我们的
点击
在
因为我们能够访问
下面是一些对于那些学习 Chrome 开发者工具的人来说可能不是特别常用的功能:
条件断点
有未捕获的异常时暂停
重启帧
监听表达式
提示 - 当调试器暂停时,你可以敲击
这里我们使用
现在我们在这个文件上运行
执行之后,我们可以在
我们可以使用右边的链接来查看和调试执行频率较高的代码路径。
一旦启用,你就可以通过敲击
提示: 在 Experiments 界面,如果你敲击
你可以重定向控制台输出到终端中(
你的脚本可以像一个普通的 Node.js 应用那样解析
现在,你的脚本看起来像这样:
输出:
使用
使用
这可以用于命令行脚本:
一些模块为了更好的在浏览器中运行或许会提供一个入口点。当你需要这些模块时,你可以使用
例如,我们可以使用 xhr-request ,当带有
在 shell 中执行:
现在,我们可以在
默认情况下,我们提供全局的
但是,你可以禁用这个方法来改善对异步堆栈跟踪的支持。
访问 这里 获取更多细节
由于程序是在一个 Browser/Electron 环境中运行,而不是在一个真正的 Node.js 环境中。因此这里有 一些陷阱 你需要注意。
目前已经存在了一些 Node.js 调试器,所以你或许想知道他们之间的区别在哪。
但是,它缺少一些 Chrome 开发者工具中的功能,例如:
一个丰富的互动的控制台
异常时暂停
异步堆栈跟踪
Promise 检查
分析
但因为你和你的 WebStorm 工作空间集成,所以你可以在调试时修改和编辑你的文件。它也是运行在一个真正的 Node/V8 环境中,而不像
一个同样基于 Electron 的调试器是 iron-node 。
而
你或许也喜欢 node-inspector ,一个使用远程调试而不是构建在 Electron 之上的工具。
这意味着你的代码将运行在一个真正的 Node 环境中,没有任何
然而,由于它重新实现了大量的调试技巧,因此对于开发来说感觉可能比最新版的 Chrome 开发者工具要慢、笨拙和脆弱。它经常会崩溃,往往导致 Node.js 开发人员很无奈。
而
下面的记录显示了在一个 HTTP 服务器中设置断点的情况。
该工具基于 Electron 将 Node.js 和 Chromium 的功能融合在了一起。它的目的在于为调试、分析和开发 Node.js 应用程序提供一个简单的界面。
你可以使用 npm 来安装它:
npm install -g devtool
在某种程度上,我们可以用它来作为
nodeshell 命令的替代品。例如,我们可以这样打开一个 REPL (译者注: REPL 全称为”Read-Eval-Print Loop”,是一个简单的、交互式的编程环境)。
devtool
这将启动一个带有 Node.js 特性支持的 Chrome 开发者工具实例。
我们可以引用 Node 模块、本地 npm 模块和像
process.cwd()这样的内置模块。也可以获取像
copy()和
table()这样的 Chrome 开发者工具中的函数。
其他的例子就一目了然了:
# run a Node script devtool app.js # pipe in content to process.stdin devtool < audio.mp3 # pipe in JavaScript to eval it browserify index.js | devtool
run a Node script
我们可以在通用模块和应用程序的开发中使用devtool,来代替像 nodemon 这样目前已经存在的工具。
devtool app.js --watch
这行命令将会在 Chrome 开发者工具中的控制台中启动我们的
app.js, 通过
--watch参数,我们保存的文件将(自动)重新载入到控制台。
点击
app.js:1链接,程序将会在
Sources标签中把我们带到与之相关的那一行。
在
Sources标签中,你也可以敲击
Cmd/Ctrl + P按键在所有依赖的模块中进行快速搜索。你甚至可以审查和调试内置模块,比如 Node.js 中的那些。你也可以使用左手边的面板来浏览模块。
因为我们能够访问
Sources标签,所以我们可以用它来调试我们的应用程序。你可以设置一个断点,然后重新加载调试器(
Cmd/Ctrl + R),或者你也可以通过
--break标记来设置一个初始断点。
devtool app.js --break
下面是一些对于那些学习 Chrome 开发者工具的人来说可能不是特别常用的功能:
条件断点
有未捕获的异常时暂停
重启帧
监听表达式
提示 - 当调试器暂停时,你可以敲击
Escape按键打开一个执行在当前作用域内的控制台。你可以修改一些变量然后继续执行。
devtool的另一个功能是分析像 browserify , gulp 和 babel 这样的程序。
这里我们使用
console.profile()(Chrome 的一个功能)来分析一个打包工具的 CPU 使用情况。
var browserify = require('browserify'); // Start DevTools profiling... console.profile('build'); // Bundle some browser application browserify('client.js').bundle(function (err, src) { if (err) throw err; // Finish DevTools profiling... console.profileEnd('build'); });
现在我们在这个文件上运行
devtool:
devtool app.js
执行之后,我们可以在
Profiles标签中看到结果。
我们可以使用右边的链接来查看和调试执行频率较高的代码路径。
高级选项
Chrome 会不断的向他们的开发者工具中推送新功能和实验,例如 Promise Inspector 。你可以通过点击右上角的三个点,然后选择Settings -> Experiments来开启他们。
一旦启用,你就可以通过敲击
Escape按键来调出一个带有 Promises 监视器的面板。
提示: 在 Experiments 界面,如果你敲击
Shift键 6 次,你会接触到一些甚至更多的实验性(不稳定)的功能。
--console
你可以重定向控制台输出到终端中( process.stdout和
process.stderr)。也允许你通过使用管道将它导入到其他进程中,例如 TAP prettifiers。
devtool test.js --console | tap-spec
--
和 process.argv
你的脚本可以像一个普通的 Node.js 应用那样解析 process.argv。如果你在
devtool命令中传递一个句号(
--),它后面的所有内容都会被当做一个新的
process.argv。例如:
devtool script.js --console -- input.txt
现在,你的脚本看起来像这样:
var file = process.argv[2]; console.log('File: %s', file);
输出:
File: input.txt
--quit
和 --headless
使用 --quit,当遇到了一个错误(如语法错误或者未捕获的异常)时,进程将会安静的退出,并返回结束码
1。
使用
--headless,开发工具将不会被打开。
这可以用于命令行脚本:
devtool render.js --quit --headless > result.png
--browser-field
一些模块为了更好的在浏览器中运行或许会提供一个入口点。当你需要这些模块时,你可以使用 --browser-field来支持 package.json flag
例如,我们可以使用 xhr-request ,当带有
"browser"字段被引用时,这个模块会使用 XHR。
const request = require('xhr-request'); request('https://api.github.com/users/mattdesl/repos', { json: true }, (err, data) => { if (err) throw err; console.log(data); });
在 shell 中执行:
npm install xhr-request --save devtool app.js --browser-field
现在,我们可以在
Network选项卡中审查请求:
--no-node-timers
默认情况下,我们提供全局的 setTimeoutand
setInterval,因此他们表现的像 Node.js 一样(返回一个带有
unref()and
ref()函数的对象)。
但是,你可以禁用这个方法来改善对异步堆栈跟踪的支持。
devtool app.js --no-node-timers
V8 Flags
在当前目录,你可以创建一个.devtoolrc文件来进行诸如 V8 flags 这样的高级设置。
{ "v8": { "flags": [ "--harmony-destructuring" ] } }
访问 这里 获取更多细节
由于程序是在一个 Browser/Electron 环境中运行,而不是在一个真正的 Node.js 环境中。因此这里有 一些陷阱 你需要注意。
目前已经存在了一些 Node.js 调试器,所以你或许想知道他们之间的区别在哪。
WebStorm 调试器
WebStorm 编辑器里面包含了一个非常强大的 Node.js 调试器。如果你已经使用 WebStorm 作为你的代码编辑器,那对你来说很棒。但是,它缺少一些 Chrome 开发者工具中的功能,例如:
一个丰富的互动的控制台
异常时暂停
异步堆栈跟踪
Promise 检查
分析
但因为你和你的 WebStorm 工作空间集成,所以你可以在调试时修改和编辑你的文件。它也是运行在一个真正的 Node/V8 环境中,而不像
devtool一样。因此对于大部分的 Node.js 应用程序来说它更稳健。
iron-node
一个同样基于 Electron 的调试器是 iron-node 。
iron-node包含了一个内置的命令来重新编译原生插件,还有一个复杂的图形界面显示您的
package.json和
README.md。
而
devtool更侧重于把命令行、Unix 风格的管道和重定向和 Electron/Browser 的 API 当作有趣的用例。
devtool提供各种各样的功能来表现的更像 Node.js (例如
require.main,
setTimeout和
process.exit),并且覆盖了内部的
require机制作为 source maps,还有改进过的错误处理、断点注入、以及
"browser"字段的解决方案。
node-inspector
你或许也喜欢 node-inspector ,一个使用远程调试而不是构建在 Electron 之上的工具。
这意味着你的代码将运行在一个真正的 Node 环境中,没有任何
window或其他的 Browser/Electron API 来污染作用域并导致某些模块出现问题。对于大型 Node.js 应用(即本地插件)来说它有一个强有力的支持,并且在开发者工具实例中拥有更多的控制权(即可以注入断点和支持网络请求)。
然而,由于它重新实现了大量的调试技巧,因此对于开发来说感觉可能比最新版的 Chrome 开发者工具要慢、笨拙和脆弱。它经常会崩溃,往往导致 Node.js 开发人员很无奈。
而
devtool的目的是让那些从 Chrome 开发者工具中转过来的人觉得比较亲切,而且也增加了像 Browser/Electron APIs 这样的功能。
相关文章推荐
- 【译】在 Chrome 开发者工具中调试 node.js
- [翻译&摘抄] 在 Chrome 开发者工具中调试 Node.js
- 【转】天啦噜!原来Chrome自带的开发者工具还能这么用!(提升JS调试能力的10个技巧)
- Node.js调试工具安装使用
- 解决chrome开发者工具无法修改js的问题
- Chrome新版JS调试工具
- 谷歌Chrome浏览器开发者工具教程—JS调试篇
- chrome开发者工具调试时改变网速
- Chrome的JS调试工具
- 开发者调试工具Chrome Workspace
- 使用 Chrome 开发者工具进行 JavaScript 问题定位与调试
- 巧用开发者工具的控制台来调试页面中的js语句
- Chrome的JS调试工具
- Node.js开发环境介绍-调试工具
- 调试Node.JS的辅助工具(NodeWatcher)
- chrome调试工具F12方式javascript(js调试)jqueryui拖拽
- Google Chrome调试js代码,开发者工具之调试工具常用功能
- 使用 Chrome 开发者工具进行 JavaScript 问题定位与调试
- Node.js内置的工具和第三方模块来进行单步调试
- Chrome开发者工具调试