process-finder

Find processes and watch ports for listener processes using a simple API

Installation

Using npm

1$ npm install process-finder --save

#find(port, fn(err, pids, data, internal))

Finds processes listening on the provided port, invokes fn with an array of pids listening on that port.

data is the output of the command that checks the status of the port. internal will contain any internal errors that might have been suppressed.

#find Usage

1var finder = require('process-finder');
2var port = 3000;
3
4finder.find(port, function(err, pids){
5    // do something about the pids listening on the port, i.e:
6    pids.forEach(process.kill);
7});

Port can be an object of options, or just a port.

1{
2    port: 3000, // the port we listen on
3    elevate: false, // whether to use `sudo`, to get elevated priviledges
4}

#watch(port)

Returns an EventEmitter that allows us to track a port's listening processes.

Port can be an object of options, or just a port.

1{
2    port: 3000, // the port we listen on
3    frequency: 200, // the frequency with which the port is scanned for changes
4    elevate: false, // whether to use `sudo`, to get elevated priviledges
5    info: false // if enabled, a verbose `info` event will be emitted
6}

#watch Usage

1var finder = require('process-finder');
2var port = 3000; // port to watch
3var watcher = finder.watch(port);
4
5watcher.on('listen', function(pid){
6    console.log(pid + ' listening on port ' + port);
7});
8
9watcher.on('unlisten', function(pid){
10    console.log(pid + ' no longer listening on port ' + port);
11});
12
13watcher.on('error', console.error);
14watcher.on('update', function(pids){
15    console.log('updated! listeners:', pids);
16});

#watch API

#watch.stop()

Stops a watch. It will no longer emit events.

#watch.start()

Starts a watch which was previously stopped using .stop()

#watch.restart()

Force-restart the watch.

#watch events

Watch extends the EventEmitter prototype, and provides a few events you can listen for.

#watch.on('start', fn())

Triggers when the watch is started, either when manually started, or when a new watch is created.

#watch.on('stop', fn())

Triggers when a watch is stopped.

#watch.on('listen', fn(pid))

Triggers when a pid is detected to be listening on the port we're watching. The pid is passed as an argument.

#watch.on('unlisten', fn(pid))

Triggers when a pid is detected to be no longer listening on the port we're watching. The pid is passed as an argument.

#watch.on('update', fn(pids))

Triggers every time the port is scanned for changes.

#watch.on('info', fn(data, internal))

data is the output of the command that checks the status of the port. internal will contain any internal errors that might have been suppressed.

#watch.on('error', fn(err))

Triggers whenever an error is thrown.

CLI

The CLI allows you to wait on a port

1procfinder --wait --port 3000

Once a process starts listening on that port, the CLI will output its pid and exit.