Chrome DevTools for Node.js


Project Name ndb Project Url https://github.com/GoogleChromeLabs/ndb#readme
InceptionYear 2011-06-21 15:56:59 更新时间 2018-11-16 10:33:21
IssueManagement https://github.com/GoogleChromeLabs/ndb/issues Licenses Apache-2.0
仓库地址 git+https://github.com/GoogleChromeLabs/ndb.git 用户数 0
Node Engine >=8.0.0 文件大小 1.1 MB
install lint prepare dummyScriptForTest unit integration


# ndb [![NPM ndb package](https://img.shields.io/npm/v/ndb.svg)](https://npmjs.org/package/ndb) > ndb is an improved debugging experience for Node.js, enabled by Chrome DevTools ## Installation Compatibility: ndb requires Node >=8.0.0. It works best with Node >=10. Installation: ndb depends on [Puppeteer](https://github.com/GoogleChrome/puppeteer) which downloads a recent version of Chromium (~170MB Mac, ~280MB Linux, ~280MB Win). ```bash # global install with npm: npm install -g ndb # alternatively, with yarn: yarn global add ndb ``` Global installation may fail with different permission errors, you can find help in this [thread](https://github.com/GoogleChromeLabs/ndb/issues/20). Windows users: Installation may fail on Windows during compilation the native dependencies. The following command may help: `npm install -g windows-build-tools` ### Local install If you want ndb available from an npm script (eg. `npm run debug` runs `ndb index.js`), you can install it as a development dependency: ```bash # local install with npm: npm install --save-dev ndb # alternatively, with yarn: yarn add ndb --dev ``` You can then [set up an npm script](https://docs.npmjs.com/misc/scripts#examples). In this case, ndb will not be available in your system path. ## Getting Started You can start debugging your Node.js application using one of the following ways: - Use `ndb` instead of the `node` command ```bash ndb server.js # Alternatively, you can prepend `ndb` ndb node server.js ``` - Prepend `ndb` in front of any other binary ```bash # If you use some other binary, just prepend `ndb` ## npm run unit ndb npm run unit # Debug any globally installed package ## mocha ndb mocha # To use a local binary, use `npx` and prepend before it ndb npx mocha ``` - Launch `ndb` as a standalone application - Then, debug any npm script from your `package.json`, e.g. unit tests ```bash # cd to your project folder (with a package.json) ndb . # In Sources panel > "NPM Scripts" sidebar, click the selected "Run" button ``` - Run any node command from within ndb's integrated terminal and ndb will connect automatically - Run any open script source by using 'Run this script' context menu item, ndb will connect automatically as well ## What can I do? `ndb` has some powerful features exclusively for Node.js: 1. Child processes are detected and attached to. 1. You can place breakpoints before the modules are required. 1. You can edit your files within the UI. On Ctrl-S/Cmd-S, DevTools will [save the changes to disk](https://developers.google.com/web/tools/chrome-devtools/workspaces/). 1. By default, ndb [blackboxes](https://developers.google.com/web/tools/chrome-devtools/javascript/reference#blackbox) all scripts outside current working directory to improve focus. This includes node internal libraries (like `_stream_wrap.js`, `async_hooks.js`, `fs.js`) This behaviour may be changed by "Blackbox anything outside working dir" setting. In addition, you can use all the DevTools functionality that you've used in [typical Node debugging](https://medium.com/@paul_irish/debugging-node-js-nightlies-with-chrome-devtools-7c4a1b95ae27): - breakpoint debugging, async stacks (AKA long stack traces), [async stepping](https://developers.google.com/web/updates/2018/01/devtools#async), etc... - console (top-level await, object inspection, advanced filtering) - [eager evaluation](https://developers.google.com/web/updates/2018/05/devtools#eagerevaluation) in console (requires Node >= 10) - JS sampling profiler - memory profiler ### Screenshot ![image](https://user-images.githubusercontent.com/39191/43023843-14a085a6-8c21-11e8-85b7-b9fd3405938a.png) ## Contributing Check out [contributing guide](https://github.com/GoogleChromeLabs/ndb/blob/master/CONTRIBUTING.md) to get an overview of ndb development. #### Thanks to the 'OG' `ndb` In early 2011, [@smtlaissezfaire](https://github.com/smtlaissezfaire) released the first serious debugger for Node.js, under the `ndb` package name. It's still preserved at [github.com/smtlaissezfaire/ndb](https://github.com/smtlaissezfaire/ndb#readme). We thank Scott for generously donating the package name.


GroupId ArtifactID Version 引用量
The Chromium Authors carlo 0.9.44 23
Paul Miller chokidar 2.1.4 5515
coderaiser fs-copy-file-sync 1.1.1 9
gjtorikian isbinaryfile 4.0.0-rc1 200
Robert Kieffer mime 2.4.2 4120
Aleksey Kozyatinskiy ndb-node-pty-prebuilt 0.8.0 1
Sindre Sorhus opn 6.0.0 5709
Sindre Sorhus update-notifier 2.5.0 2339
Einar Otto Stangvik ws 6.2.1 5753
paris xterm 3.12.1 142


GroupId ArtifactID Version 引用量
Nicholas C. Zakas eslint 5.16.0 136868
Mihai Bazon terser 3.17.0 545