The find-process npm package is a utility that allows users to find and list processes running on the system based on a given query, such as process name, port, or process ID. It provides a simple and efficient way to retrieve information about system processes, which can be useful for monitoring and management tasks in Node.js applications.

What are find-process's main functionalities?

Find process by name

This feature allows users to find processes by their name. The code sample demonstrates how to use find-process to search for all processes with the name 'node'. The function returns a promise that resolves to a list of processes matching the query.

const find = require('find-process');

find('name', 'node').then(function (list) {
  console.log(list);
});

Find process by port

This feature enables users to find processes using a specific port. In the provided code, find-process is used to search for any process that is using port 8080. The result is a list of processes that are returned after the promise resolves.

const find = require('find-process');

find('port', 8080).then(function (list) {
  console.log(list);
});

Find process by pid

This functionality allows the user to find a process by its process ID (pid). The code example shows how to find a process with the pid 12345. The function returns a promise that provides the details of the process if found.

const find = require('find-process');

find('pid', 12345).then(function (list) {
  console.log(list);
});

Other packages similar to find-process

Readme

Source

find-process

With find-process, you can:

find the process which is listening specified port
find the process by pid
find the process by given name or name pattern

We have covered the difference of main OS platform, including Mac OSX, Linux, Windows and Android (with Termux).

CLI

Install find-process as a CLI tool:

$ npm install find-process -g

Usage:


  Usage: find-process [options] <keyword>


  Options:

    -V, --version      output the version number
    -t, --type <type>  find process by keyword type (pid|port|name)
    -p, --port         find process by port
    -h, --help         output usage information

  Examples:

    $ find-process node          # find by name "node"
    $ find-process 111           # find by pid "111"
    $ find-process -p 80         # find by port "80"
    $ find-process -t port 80    # find by port "80"

Example:

Node API

You can use npm to install:

$ npm install find-process --save

Usage:

const find = require('find-process');

find('pid', 12345)
  .then(function (list) {
    console.log(list);
  }, function (err) {
    console.log(err.stack || err);
  })

Synopsis

Promise<Array> find(type, value, [strict])

Arguments

type the type of find, support: port|pid|name
value the value of type, can be RegExp if type is name
strict the optional strict mode is for checking port, pid, or name exactly matches the given one. (on Windows, .exe can be omitted)

Return

The return value of find-process is Promise, if you use co you can use yield find(type, value) directly.

The resolved value of promise is an array list of process ([] means it may be missing on some platforms):

[{
  pid: <process id>,
  ppid: [parent process id],
  uid: [user id (for *nix)],
  gid: [user group id (for *nix)],
  name: <command/process name>,
  bin: <execute path (for *nix)>,
  cmd: <full command with args>
}, ...]

Example

Find process which is listening port 80.

const find = require('find-process');

find('port', 80)
  .then(function (list) {
    if (!list.length) {
      console.log('port 80 is free now');
    } else {
      console.log('%s is listening port 80', list[0].name);
    }
  })

Find process by pid.

const find = require('find-process');

find('pid', 12345)
  .then(function (list) {
    console.log(list);
  }, function (err) {
    console.log(err.stack || err);
  });

Find all nginx process.

const find = require('find-process');

find('name', 'nginx', true)
  .then(function (list) {
    console.log('there are %s nginx process(es)', list.length);
  });

Contributing

We're welcome to receive Pull Request of bugfix or new feature, but please check the list before sending PR:

Coding Style Please follow the Standard Style
Documentation Add documentation for every API change
Unit test Please add unit test for bugfix or new feature

License

MIT

Keywords

FAQs

What is find-process?

Is find-process popular?

Is find-process well maintained?

Last updated on 18 Nov 2021

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install