Child_process_inspect NPM

child_process_inspect

Convenience methods for debugging child processes in Node.JS. Child processes will be started with --inspect if the parent was started with --inspect and the children will each get their own increasing port number based off the parent's port number. The default port is 5858. If you add --inspect-brk that will also get passed to the children.

Example

var childProcessDebug = require('child_process_inspect');

for (var i = 0; i < 4; i++) {
    //if this script wasn't run with --inspect this will spawn node example.js [0-3]
    //if this script was run with --inspect, this will spawn node --inspect=[5859-5862] example.js [0-3]
    childProcessDebug.spawn(['example.js', i]);
}

Methods

spawn(command , options)

This takes the exact same arguments as child_process.spawn and if the parent had debugging turned on (via --inspect), it'll turn on debugging for the spawned child. command is also optional (unlike child_process.spawn) and defaults to process.execPath.

The ChildProcess returned from spawn will have a property called debugPort indicating the debug port chosen for that child or undefined.

fork(modulePath , args)

This takes the exact same arguments as child_process.fork and if the parent had debugging turned on (via --inspect), it'll turn on debugging for the spawned child. Return is the same as spawn above.

nextPort()

Returns the next debug port that comes after the current process's debug port. If the current process doesn't have debug turned on then this will return undefined. This is useful if you're not using spawn and want to specify the --inspect=port argument yourself.