Need help with ndb?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

10.5K Stars 254 Forks Apache License 2.0 224 Commits 50 Opened issues


ndb is an improved debugging experience for Node.js, enabled by Chrome DevTools

Services available


Need anything else?

Contributors list


Build Status NPM ndb package <!-- [END badges] -->

ndb is an improved debugging experience for Node.js, enabled by Chrome DevTools


Compatibility: ndb requires Node >=8.0.0. It works best with Node >=10.

Installation: ndb depends on Puppeteer which downloads a recent version of Chromium (~170MB Mac, ~280MB Linux, ~280MB Win).

# 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.

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
ndb index.js
), you can install it as a development dependency:
# local install with npm:
npm install --save-dev ndb

alternatively, with yarn:

yarn add ndb --dev

You can then set up an npm script. 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
    instead of the
ndb server.js

Alternatively, you can prepend ndb

ndb node server.js

  • Prepend
    in front of any other binary
# If you use some other binary, just prepend `ndb`
## npm run unit
ndb npm run unit

Debug any globally installed package


ndb mocha

To use a local binary, use npx and prepend before it

ndb npx mocha

  • Launch
    as a standalone application
    • Then, debug any npm script from your
      , e.g. unit tests
# cd to your project folder (with a package.json)
ndb .
# In Sources panel > "NPM Scripts" sidebar, click the selected "Run" button 
  • Use
    to restart last run
  • 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

  • Use

    flag to profile your app,
    restarts profiling
    ndb --prof npm run unit

What can I do?

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. 1. By default, ndb blackboxes all scripts outside current working directory to improve focus. This includes node internal libraries (like
) 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: - breakpoint debugging, async stacks (AKA long stack traces), async stepping, etc... - console (top-level await, object inspection, advanced filtering) - eager evaluation in console (requires Node >= 10) - JS sampling profiler - memory profiler




Check out contributing guide to get an overview of ndb development.

Thanks to the 'OG'

In early 2011, @smtlaissezfaire released the first serious debugger for Node.js, under the

package name. It's still preserved at We thank Scott for generously donating the package name.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.