Skip to content
Web Inspector based nodeJS debugger
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Node Inspector is a debugger interface for nodeJS using the WebKit Web Inspector.

Getting Started


  • nodeJS
    • versions: 0.1.101 or later
  • A WebKit based browser: Chrome, Safari, OmniWeb, etc.



As an example lets debug test/hello.js, from the root project directory (node-inspector)

  1. start the inspector in the background node bin/inspector.js &

    or with npm just run node-inspector &

  2. start the node instance to debug node --debug test/hello.js

  3. open in your favorite WebKit based browser

    Chrome 5 users MUST use NOT localhost or the browser will not connect to the debugger

  4. you should now see the javascript source from nodeJS

  5. set some breakpoints, see what happens

For more information on getting started see the wiki


    --web-port=[port]     port to host the inspector (default 8080)


This project started as a Chrome extension. For more info see the wiki.

Cool stuff

  • the WebKit Web Inspector debugger is a great js debugger interface, it works just as well for node
  • uses a WebSocket to connect to debug-agent, so no polling for breaks
  • remote debugging
  • javascript top to bottom :)

Known Issues

This is alpha quality code, so use at your own risk:

  • be careful about viewing the contents of Buffer objects, each byte is displayed as an individual array element, for anything but tiny Buffers this will take too long to render
  • while not stopped at a breakpoint the console doesn't always behave as you might expect
  • pause on exceptions doesn't play nice with the node event loop
  • closing the inspector does not stop debugging, you must stop inspector.js manually


  • save application settings
  • profiler panel


This project respectfully uses code from and thanks the authors of:

Something went wrong with that request. Please try again.