{"id":17122801,"url":"https://github.com/ibrahimgunduz34/process-list","last_synced_at":"2026-04-12T00:43:58.115Z","repository":{"id":41872495,"uuid":"484565077","full_name":"ibrahimgunduz34/process-list","owner":"ibrahimgunduz34","description":"A simple library to retrieve the running process list for Node.js","archived":false,"fork":false,"pushed_at":"2022-04-25T13:01:19.000Z","size":18,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-04-29T20:22:34.925Z","etag":null,"topics":["backend","freebsd","linux","monitoring","nodejs","os","osx","system-information","windows"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ibrahimgunduz34.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-04-22T20:36:18.000Z","updated_at":"2023-03-08T16:16:33.000Z","dependencies_parsed_at":"2022-08-11T19:50:50.015Z","dependency_job_id":null,"html_url":"https://github.com/ibrahimgunduz34/process-list","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibrahimgunduz34%2Fprocess-list","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibrahimgunduz34%2Fprocess-list/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibrahimgunduz34%2Fprocess-list/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibrahimgunduz34%2Fprocess-list/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ibrahimgunduz34","download_url":"https://codeload.github.com/ibrahimgunduz34/process-list/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245200701,"owners_count":20576674,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backend","freebsd","linux","monitoring","nodejs","os","osx","system-information","windows"],"created_at":"2024-10-14T18:23:55.670Z","updated_at":"2025-10-29T00:20:24.232Z","avatar_url":"https://github.com/ibrahimgunduz34.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Npm Publish Workflow](https://github.com/ibrahimgunduz34/process-list/actions/workflows/npm-publish.yml/badge.svg)](https://github.com/ibrahimgunduz34/process-list/actions/workflows/npm-publish.yml)\n\n# ProcessList\n\nIt's a library that simply wrap the `ps` command in order to access the active process list from your application.\n\n## Installation:\n\n```bash\n$ npm install @ibrahimgunduz34/process-list\n```\n\n## Reference:\n\n| Method                                 | Description                       |\n|----------------------------------------|-----------------------------------|\n| getList(asArray, options): Promise\u003c[]\u003e | Returns list of running processes |\n\n### getList(asArray, options): Promise\u003c[]\u003e:\n\n#### Parameters:\n\n| Parameter  | Type     | Required | Default       | Description |\n|------------|----------|----------|---------------|-----------------------------------|\n| asArray    | boolean  | No       | false         | It allows the method to return the running processes as an array. The first item of the array would be the column list. By default, it takes false value and the method would returns the running processes as a list of objects that contains the process details with their column names. |\n| options    | array    | No       | ['a','u','x'] | It allows passing extra arguments to the ps command.  |\n\n#### Return:\nIt returns a Promise with the list of running processes as objects or arrays.\n\n## Usage:\n\n```javascript\nconst ProcessList = require('process-list');\n\n// ...\n\nconst processes = await ProcessList.getList();\n/**\n  [\n    {\n      USER: 'root',\n      PID: '6029',\n      '%CPU': '0.0',\n      '%MEM': '0.0',\n      VSZ: '0',\n      RSS: '0',\n      TTY: '?',\n      STAT: 'I',\n      START: '09:56',\n      TIME: '0:00',\n      COMMAND: '[kworker/u4:2-events_unbound]'\n    },\n    {\n      USER: 'root',\n      PID: '6036',\n      '%CPU': '0.0',\n      '%MEM': '0.0',\n      VSZ: '0',\n      RSS: '0',\n      TTY: '?',\n      STAT: 'I',\n      START: '09:56',\n      TIME: '0:00',\n      COMMAND: '[kworker/0:2-events]'\n    },\n    {\n      USER: 'vagrant',\n      PID: '6385',\n      '%CPU': '0.0',\n      '%MEM': '3.2',\n      VSZ: '512544',\n      RSS: '32736',\n      TTY: 'pts/0',\n      STAT: 'Rl+',\n      START: '10:03',\n      TIME: '0:00',\n      COMMAND: 'node src/ntop.js'\n    }\n  ]\n*/ \n\n//...\n\nconst processes = await ProcessList.getList({asArray: true});\n/**\n  [\n    [\n      'USER',\n      'PID',\n      '%CPU',\n      '%MEM',\n      'VSZ',\n      'RSS',\n      'TTY',\n      'STAT',\n      'START',\n      'TIME',\n      'COMMAND'\n    ],\n    [\n      'root',\n      '6029',\n      '0.0',\n      '0.0',\n      '0',\n      '0',\n      '?',\n      'I',\n      '09:56',\n      '0:00',\n      '[kworker/u4:2-events_unbound]'\n    ],\n    [\n      'root',\n      '6036',\n      '0.0',\n      '0.0',\n      '0',\n      '0',\n      '?',\n      'I',\n      '09:56',\n      '0:00',\n      '[kworker/0:2-events]'\n    ],\n    [\n      'vagrant',\n      '6385',\n      '0.0',\n      '3.2',\n      '512544',\n      '32736',\n      'pts/0',\n      'Rl+',\n      '10:03',\n      '0:00',\n      'node src/ntop.js'\n    ]\n  ]\n */\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibrahimgunduz34%2Fprocess-list","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fibrahimgunduz34%2Fprocess-list","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibrahimgunduz34%2Fprocess-list/lists"}