Have ideas to improve npm?Join in the discussion! »

    procman

    0.0.3 • Public • Published

    Process Management for NodeJS

    This module provides advanced facilities for querying and manipulating running processes on macOS and Linux. It does so by integrating with the relevant routines provided by the OS.

    ⚠️ Windows is not (yet) supported.

    Features

    • Query whether any process is running, even daemons and non-GUI applications on macOS.
    • Connect to a process and be notified when it is done.
    • Send a custom signal to a process
    • Kill a process

    Pull requests are welcome!

    Example

    wait-until-exit.js

    #!/usr/bin/env node
     
    import { Process } from "procman"
     
    const pid = Number(processes.argv[2])
     
    if (isNaN(pid)) {
      console.error('Not a valid PID.')
      process.exit(1)
    }
     
    const myProc = new Process(pid)
     
    myProc.on('exit', () => {
      console.log('The process has exited.')
    })

    API

    new Process(pid)

    Connects to the given process indicated by the PID number and waits for it to exit. NodeJS will be forced to keep running until the process exits or Process.close() is explicitly called.

    Process.running

    Indicates whether the given process is running right now. This value might change even during the same execution context.

    Process.on('exit', callack)

    Registers a callback to be executed when the process exits.

    Process.close()

    Stops monitoring the process and allows NodeJS to exit.

    Process.kill(signal?)

    Send the given signal to the process.

    If no signal is provided, will default to SIGTERM.

    License

    The code is licensed under the MIT license, which means you may use it in commercial products as long as you retain the copyright information.

    Install

    npm i procman

    DownloadsWeekly Downloads

    5

    Version

    0.0.3

    License

    MIT

    Unpacked Size

    21.6 kB

    Total Files

    6

    Last publish

    Collaborators

    • avatar