JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 55124
  • Score
    100M100P100Q163560F
  • License MIT

Wrapper for the Windows `tasklist` command. Returns a list of apps and services with their Process ID (PID) for all tasks running on either a local or a remote computer.

Package Exports

  • tasklist

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (tasklist) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

tasklist Build Status

Wrapper for the Windows tasklist command. Returns a list of apps and services with their Process ID (PID) for all tasks running on either a local or a remote computer.

Cleans up and normalizes the data.

Install

$ npm install tasklist

Usage

const tasklist = require('tasklist');

(async () => {
    console.log(await tasklist());
    /*
    [{
        imageName: 'taskhostex.exe',
        pid: 1820,
        sessionName: 'Console',
        sessionNumber: 1,
        memUsage: 4415488
    }, …]
    */
})();

API

See the tasklist docs for more.

tasklist(options?)

Returns a Promise<Array> with running tasks.

options

Type: object

The system, username, password options must be specified together.

verbose

Type: boolean
Default: false

Return verbose results.

Without the verbose option, taskkill returns tasks with the following properties:

  • imageName (Type: string)
  • pid (Type: number)
  • sessionName (Type: string)
  • sessionNumber (Type: number)
  • memUsage in bytes (Type: number)

With the verbose option set to true, it additionally returns the following properties:

  • status (Type: string): One of Running, Suspended, Not Responding, or Unknown
  • username (Type: string)
  • cpuTime in seconds (Type: number)
  • windowTitle (Type: string)

Note: It's not guaranteed that the username and windowTitle properties are returned with proper values. If they are not available, 'N/A' may be returned on English systems. In contrast, 'Nicht zutreffend' may be returned on German systems, for example.

Verbose example:

const tasklist = require('tasklist');

(async () => {
    console.log(await tasklist({verbose: true}));
    /*
    [{
        imageName: 'taskhostex.exe',
        pid: 1820,
        sessionName: 'Console',
        sessionNumber: 1,
        memUsage: 4415488,
        status: 'Running',
        username: 'SINDRESORHU3930\\sindre'
        cpuTime: 0,
        windowTitle: 'Task Host Window'
    }, …]
    */
})();

Warning: Using the verbose option may have a considerable performance impact (See: #6).

system

Type: string

Name or IP address of a remote computer (don't use backslashes). The default is the local computer.

username

Type: string
Example: SINDRESORHU3930\\sindre

User specified by User or Domain\User. The default is the permissions of the current logged on user on the computer issuing the command.

password

Type: string

Password of the user account for the specified username.

filter

Type: array

Specify the types of processes to include or exclude. More info.

  • taskkill - Wrapper for the Windows taskkill command

Maintainers