JavaScript 程序越來越復雜,調試工具的重要性日益凸顯。客戶端腳本有瀏覽器,Node 腳本怎麽調試呢?
2016年,Node 決定將 Chrome 瀏覽器的"開發者工具"作為官方的調試工具,使得 Node 腳本也可以使用圖形界面調試,這大大方便了開發者。
本文介紹如何使用 Node 腳本的調試工具。
壹、示例程序
為了方便講解,下面是壹個示例腳本。首先,新建壹個工作目錄,並進入該目錄。
$ mkdir debug-demo
$ cd debug-demo然後,生成 package.json 文件,並安裝Koa 框架和 koa-route 模塊。
$ npm init -y
$ npm install --save koa koa-route接著,新建壹個腳本 app.js ,並寫入下面的內容。
// app.js
const Koa = require('koa');
const router = require('koa-route');
const app = new Koa();
const main = ctx => {
ctx.response.body = 'Hello World';
};
const welcome = (ctx, name) => {
ctx.response.body = 'Hello ' + name;
};
app.use(router.get('/', main));
app.use(router.get('/:name', welcome));
app.listen(3000);
console.log('listening on port 3000');上面代碼是壹個簡單的 Web 應用,指定了兩個路由,訪問後會顯示壹行歡迎信息。如果想詳細了解代碼的詳細含義,可以參考Koa 教程。
二、啟動開發者工具
現在,運行上面的腳本。
$ node --inspect app.js上面代碼中, --inspect 參數是啟動調試模式必需的。這時,打開瀏覽器訪問 http://127.0.0.1//3000,就可以看到 Hello World 了。
接下來,就要開始調試了。壹***有兩種打開調試工具的方法,第壹種是在 Chrome 瀏覽器的地址欄,鍵入 chrome://inspect 或者 about:inspect ,回車後就可以看到下面的界面。
在 Target 部分,點擊 inspect 鏈接,就能進入調試工具了。
第二種進入調試工具的方法,是在 http://127.0.0.1//3000 的窗口打開"開發者工具",頂部左上角有壹個 Node 的綠色標誌,點擊就可以進入。
三、調試工具窗口
調試工具其實就是"開發者工具"的定制版,省去了那些對服務器腳本沒用的部分。
它主要有四個面板。
Console:控制臺
Memory:內存
Profiler:性能
Sources:源碼
這些面板的用法,基本上跟瀏覽器環境差不多,這裏只介紹 Sources (源碼)面板。
四、設置斷點
進入 Sources 面板,找到正在運行的腳本 app.js 。
在第11行(也就是下面這壹行)的行號上點壹下,就設置了壹個斷點。
ctx.response.body = 'Hello ' + name;
這時,瀏覽器訪問 http://127.0.0.1:3000/alice ,頁面會顯示正在等待服務器返回。切換到調試工具,可以看到 Node 主線程處於暫停(paused)階段。
進入 Console 面板,輸入 name,會返回 alice。這表明我們正處在斷點處的上下文(context)。
再切回 Sources 面板,右側可以看到 Watch、Call Stack、Scope、Breakpoints 等折疊項。打開 Scope 折疊項,可以看到 Local 作用域和 Global 作用域裏面的所有變量。
Local 作用域裏面,變量 name 的值是 alice ,雙擊進入編輯狀態,把它改成 bob 。
然後,點擊頂部工具欄的繼續運行按鈕。
頁面上就可以看到 Hello bob 了。
命令行下,按下 ctrl + c,終止運行 app.js 。
五、調試非服務腳本
Web 服務腳本會壹直在後臺運行,但是大部分腳本只是處理某個任務,運行完就會終止。這時,妳可能根本沒有時間打開調試工具。等妳打開了,腳本早就結束運行了。這時怎麽調試呢?
$ node --inspect=9229 -e "setTimeout(function() { console.log('yes'); }, 30000)"上面代碼中, --inspect=9229 指定調試端口為 9229,這是調試工具默認的通信端口。 -e 參數指定壹個字符串,作為代碼運行。
訪問 chrome://inspect ,就可以進入調試工具,調試這段代碼了。
代碼放在 setTimeout 裏面,總是不太方便。那些運行時間較短的腳本,可能根本來不及打開調試工具。這時就要使用下面的方法。
$ node --inspect-brk=9229 app.js上面代碼中, --inspect-brk 指定在第壹行就設置斷點。也就是說,壹開始運行,就是暫停的狀態。
六、忘了寫 --inspect 怎麽辦?
打開調試工具的前提是,啟動 Node 腳本時就加上 --inspect 參數。如果忘了這個參數,還能不能調試呢?
回答是可以的。首先,正常啟動腳本。
$ node app.js然後,在另壹個命令行窗口,查找上面腳本的進程號。
$ ps ax | grep app.js
30464 pts/11 Sl+ 0:00 node app.js
30541 pts/12 S+ 0:00 grep app.js上面命令中, app.js 的進程號是 30464 。
接著,運行下面的命令。
$ node -e 'process._debugProcess(30464)'上面命令會建立進程 30464 與調試工具的連接,然後就可以打開調試工具了。
還有壹種方法,就是向腳本進程發送 SIGUSR1 信號,也可以建立調試連接。
$ kill -SIGUSR1 30464相信看了本文案例妳已經掌握了方法,更多精彩請關註Gxl網其它相關文章!
推薦閱讀:
如何利用Node靜態資源服務器
nodejs+mysql怎樣操作數據庫