Repositorio del curso CCOM4030 el semestre B91 del proyecto Artesanías con el Instituto de Cultura

Changelog

Major Changes - Version 4

New Functions

  • chassis(): chassis information

Breaking Changes

  • networkStats(): will provide an array of stats for all given interfaces. In previous versions only one interface was provided as a parameter. Pass ‘*’ for all interfaces
  • networkStats(): rx and tx changed to rx_bytes and tx_bytes
  • dockerContainerStats(): will provide an array of stats for all given docker containers. In previous versions only one interface was provided as a parameter. Pass ‘*’ for all docker containers

Other Changes

  • system() optimized system detection (e.g. new Raspberry Pi models, …)
  • system(), bios(), baseboard() information also as non-root (linux)
  • graphics() better controller and display detection, fixes
  • versions() optimization, fixes
  • networkInterfaces() added operstate, type, duplex, mtu, speed, carrierChanges
  • networkStats() added stats for errors, dropped
  • added TypeScript definitions

Be aware, that the new version 4.x is NOT fully backward compatible to version 3.x …

For major (breaking) changes - version 3 and 2 see end of page.

Version history

Version Date Comment
4.30.11 2020-12-02 cpu() bug fix speed parsing
4.30.10 2020-12-01 cpu() handled speed parsing error (Apple Silicon)
4.30.9 2020-12-01 cpu() corrected processor names (Raspberry Pi)
4.30.8 2020-11-30 fsSize() catch error (mac OS)
4.30.7 2020-11-29 cpuTemperature() rewrite hwmon parsing
4.30.6 2020-11-27 wmic added default windows path (windows)
4.30.5 2020-11-26 adapted security update (prototype pollution prevention)
4.30.4 2020-11-25 reverted Object.freeze because it broke some projects
4.30.3 2020-11-25 security update (prototype pollution prevention) Object.freeze
4.30.2 2020-11-25 security update (prototype pollution prevention)
4.30.1 2020-11-12 updated docs
4.30.0 2020-11-12 get() possibility to provide params
4.29.3 2020-11-09 blockdevices() catch errors adapted for just one line
4.29.2 2020-11-09 blockdevices() catch errors
4.29.1 2020-11-08 cpu(), system() better parsing Raspberry Pi revision codes
4.29.0 2020-11-08 fsSize() correct fs type detection macOS (HFS, APFS, NFS)
4.28.1 2020-11-05 code cleanup, removing debug console.log()
4.28.0 2020-11-04 graphics() added deviceName (windows)
4.27.11 2020-10-26 inetChecksite() fixed vulnerability: command injection
4.27.10 2020-10-16 dockerContainers() resolved hanging issue
4.27.9 2020-10-13 networkInterfaces() loopback internal detection (windows)
4.27.8 2020-10-08 windows codepages partial fix
4.27.7 2020-10-05 updated typescript typings, minor fixes
4.27.6 2020-10-02 get() fixed when results are in arrays
4.27.5 2020-09-18 cpuTemperature() fix try catch (linux)
4.27.4 2020-09-16 networkInterfaceDefault() optimization (macOS)
4.27.3 2020-08-26 updated typescript typings
4.27.2 2020-08-26 fixed issue breaking node v4 compatibility
4.27.1 2020-08-25 networkStats() fixed packages dropped (linux)
4.27.0 2020-08-24 observe() added function to observe/watch system parameters
4.26.12 2020-08-21 versions() fixed issue windows
4.26.11 2020-08-20 cpuTemperature() fixed issue windows
4.26.10 2020-07-16 networkStats() fixed issue blocking windows
4.26.9 2020-06-06 networkStats() fixed comparison issue windows
4.26.8 2020-06-06 networkInterfaces() fixed caching issue
4.26.7 2020-06-06 cpuTemperature() fixed raspberry pi sensors issue
4.26.6 2020-06-03 diskLayout() fixed issue linux
4.26.5 2020-05-27 cpuTemperature() optimizes scanning AMD linux sensors
4.26.4 2020-05-21 cpuTemperature() fix (BSD), code cleanup
4.26.3 2020-05-20 updated documentation (macOS temperature)
4.26.2 2020-05-19 processes() memory leak fix
4.26.1 2020-05-13 code cleanup
4.26.0 2020-05-12 diskLayout() added full smart data where supported
4.25.2 2020-05-12 getDynamicData() added wifiNetworks()
4.25.1 2020-05-07 get() minor bounds test fix, updated docs
4.25.0 2020-05-07 get() added function to get partial system info
4.24.2 2020-05-06 cpu() fix (BSD), networkStats() fix BSD
4.24.1 2020-05-03 processes() fix parsing command and params
4.24.0 2020-05-01 networkInterfaces() added subnet mask ip4 and ip6
4.23.10 2020-05-01 cpuTemperature() optimized parsing linux
4.23.9 2020-04-29 currentLoad() workarround for no os.cpus info
4.23.8 2020-04-26 getMacAddresses() fix added try catch
4.23.7 2020-04-26 getCpuCurrentSpeedSync() workarround fix
4.23.6 2020-04-25 networkGatewayDefault() bug fix no interfaces
4.23.5 2020-04-20 updated docs
4.23.4 2020-04-20 users() optimized parseDateTime function
4.23.3 2020-04-09 refactored to avoid cat
4.23.2 2020-04-08 cpu() fixed getting base frequency for AMD Ryzen
4.23.1 2020-03-11 diskLayout() optimized detection linux
4.23.0 2020-03-08 versions() added param to specify which program/lib versions to detect
4.22.7 2020-03-08 diskLayout() fixed linux
4.22.6 2020-03-08 network() fixed DHCP linux
4.22.5 2020-03-04 graphics() fixed vram macOS
4.22.4 2020-03-01 versions() added dotnet, typings fix
4.22.3 2020-02-20 memLayout() code cleanup
4.22.2 2020-02-19 memLayout() raspberry PI mem voltage fix
4.22.1 2020-02-17 memLayout() raspberry PI support
4.22.0 2020-02-17 services() added pids (windows)
4.21.3 2020-02-16 versions() fixed mysql version (macOS)
4.21.2 2020-02-11 networkConnections() fixed linux (debian) issue
4.21.1 2020-01-31 networkGatewayDefault() fixed windows 7 issue
4.21.0 2020-01-27 npx compatibility
4.20.1 2020-01-26 battery() code refactoring, cleanup, updated docs
4.20.1 2020-01-26 battery() code refactoring, cleanup, updated docs
4.20.0 2020-01-25 battery() added designcapacity, voltage, unit
4.19.4 2020-01-24 mem() prevent log messages, memgetDefaultNetworkInterface() catch errors
4.19.3 2020-01-24 memLayout() bank info fix macOS
4.19.2 2020-01-19 cpu() muli-processor fix windows
4.19.1 2020-01-14 osInfo() uefi fix windows
4.19.0 2020-01-12 osInfo() added uefi
4.18.3 2020-01-10 fsSize() fix excluding loop/snap devices
4.18.2 2020-01-10 memLayout() fix memsize linux (modules >= 32 GB)
4.18.1 2020-01-07 updated docs
4.18.0 2020-01-07 networkInterfaces() added dhcp for mac os, added dhcp linux fallback
4.17.3 2020-01-05 code cleanup
4.17.2 2020-01-05 cpu().speed AMD base frequency and fix (0.00)
4.17.1 2020-01-04 fsSize() alpine linux support
4.17.0 2020-01-04 networkInterfaces() added dhcp, dnsSuffix, ieee8021xAuth, ieee8021xState
4.16.1 2020-01-02 networkInterfaces() bug fix (osx)
4.16.0 2019-11-27 networkGatewayDefault() added
4.15.3 2019-11-10 type definitions and docs update
4.15.2 2019-11-10 mem() improved calculation linux
4.15.1 2019-11-10 diskLayout() added support for older lsblk versions (linux)
4.15.0 2019-11-10 cpu() added governor (linux)
4.14.17 2019-10-22 graphics() improved display detection (windows)
4.14.16 2019-10-19 graphics() improved display detection (windows)
4.14.15 2019-10-18 graphics() fallback display detection (windows)
4.14.14 2019-10-18 powerShell() fixed error handling (windows)
4.14.13 2019-10-15 networkConnections() fixed parsing (linux)
4.14.12 2019-10-14 getCpu() fixed multi socket detection (linux)
4.14.11 2019-10-01 type definitions fix dockerInfo
4.14.10 2019-10-01 type definitions fix memLayout
4.14.9 2019-10-01 processLoad() fix windows
4.14.8 2019-08-22 parseDateTime() fix coding error
4.14.7 2019-08-22 battery() windows acconnected improvement
4.14.6 2019-08-22 users() improved date time parsing
4.14.5 2019-08-22 fsSize() fix windows result as number
4.14.4 2019-07-20 verions() fix pip, pip3
4.14.3 2019-07-09 system() sku fix windows
4.14.2 2019-07-07 networkConnections() pid linux fix NAN
4.14.1 2019-07-04 graphics() added display position windows
4.14.0 2019-07-03 processes() added process path and params
4.13.2 2019-07-02 versions() fix getting all versions
4.13.1 2019-07-01 versions() gcc fix macos
4.13.0 2019-07-01 networkConnections() added PID and process
4.12.2 2019-06-24 system() added Raspberry PI 4 detection
4.12.1 2019-06-24 networkInterface() virtual interfaces macos, networkInterfaceDefault()
4.12.0 2019-06-21 networkInterface() added property virtual
4.11.6 2019-06-19 util bug fix
4.11.5 2019-06-19 dockerAll() bug fix
4.11.4 2019-06-17 type definitions bug fix
4.11.3 2019-06-16 graphics() optimization windows
4.11.2 2019-06-16 wifiNetworks() bug fixes
4.11.1 2019-06-15 updated docs
4.11.0 2019-06-14 wifiNetworks() added available wifi networks
4.10.0 2019-06-14 graphics() windows multiple display support
4.9.2 2019-06-12 type definitions bug fix
4.9.1 2019-06-11 networkStats() bug fix windows
4.9.0 2019-06-03 graphics() added vendor, refresh rate, current res
4.8.4 2019-06-03 vboxInfo() fixed call parameters
4.8.3 2019-06-01 vboxInfo() added stoppedSince, started, stopped
4.8.2 2019-05-31 dockerInfo() changed property naming style
4.8.1 2019-05-31 updated docs
4.8.0 2019-05-31 added vboxInfo() detailed virtual box info
4.7.3 2019-05-30 updated typescript typings
4.7.2 2019-05-30 versions() added virtualbox, java popup fix macos
4.7.1 2019-05-29 memLayout() fix macos mojave
4.7.0 2019-05-29 partial netBSD support
4.6.1 2019-05-29 get wmic path - fic windows
4.6.0 2019-05-27 added dockerInfo()
4.5.1 2019-05-17 updated docs
4.5.0 2019-05-17 fsOpenFiles() added open file descriptor count
4.4.1 2019-05-11 updated docs
4.4.0 2019-05-11 dockerContainers() added started, finished time
4.3.0 2019-05-09 dockerContainers() dockerStats() added restartCount
4.2.1 2019-05-09 networkInterfaceDefault() time delay fix (linux)
4.2.0 2019-05-09 osInfo() extended service pack version (windows)
4.1.8 2019-05-09 graphics() resolve on error (windows)
4.1.7 2019-05-09 users() parsing fix (windows)
4.1.6 2019-04-24 memory() swap used fix (linux)
4.1.5 2019-04-19 refactored wmic calls to work also on Windows XP
4.1.4 2019-03-26 networkInterfaces() speed bug (windows)
4.1.3 2019-03-24 wmic path detection (windows)
4.1.2 2019-03-23 updated docs
4.1.1 2019-03-13 updated typescript typings
4.1.0 2019-03-13 versions() added pip, pip3
4.0.16 2019-03-12 Happy birthday - 5th aniversary
4.0.15 2019-03-02 versions() added java, python3, optimized gcc
4.0.14 2019-03-01 updated typescript typings
4.0.13 2019-03-01 diskLayout() added device (/dev/sda…) linux, mac
4.0.12 2019-03-01 diskLayout() linux rewritten - better detection
4.0.11 2019-02-23 users() fix windows (time), added @ts-check
4.0.10 2019-02-10 networkInterfaceDefault() fix windows
4.0.9 2019-02-08 cpu() fix, code cleanup
4.0.8 2019-02-05 inetLatency() Windows fix parse chinese output
4.0.7 2019-02-05 inetLatency() Windows fix
4.0.6 2019-02-04 powershell catch error
4.0.5 2019-02-03 updated docs
4.0.4 2019-02-03 code cleanup, updated docs
4.0.3 2019-02-03 networkInterfaces(), chassis() fixed two more issues
4.0.2 2019-02-03 networkInterfaces(), chassis() fixed smaller issues
4.0.1 2019-02-02 updated docs
4.0.0 2019-02-02 new major version
3.54.0 2018-12-30 added TypeScript type definitions
3.53.1 2018-12-29 versions() bug fix nginx version
3.53.0 2018-12-29 versions() added perl, python, gcc
3.52.7 2018-12-29 versions() bug fix macOS detection
3.52.6 2018-12-28 versions() bug fix macOS
3.52.5 2018-12-28 preparing automated tests, travis-ci integration, added dev-dependencies
3.52.4 2018-12-27 graphics().controllers bugfix linux
3.52.3 2018-12-27 os().codepage bugfix
3.52.2 2018-12-17 code cleanup
3.52.1 2018-12-17 inetChecksite() bugfix windows
3.52.0 2018-12-15 cpu() added physical cores, processors, socket type
3.51.4 2018-12-05 versions() bugfix, optimization postgres
3.51.3 2018-11-27 mem() refactoring parsing linux, code cleanup
3.51.2 2018-11-26 mem() bugfix parsing free output linux
3.51.1 2018-11-26 processLoad() bugfix windows
3.51.0 2018-11-25 processLoad() added for windows
3.50.3 2018-11-25 processLoad(), services() fixed cpu data (linux)
3.50.2 2018-11-23 network mac adresses: ip support fix
3.50.1 2018-11-23 services() added possibility to specify ALL services “*” for win
3.50.0 2018-11-23 services() added possibility to specify ALL services “*” for linux
3.49.4 2018-11-21 battery() timeremaining optimization (linux) thanks to Jorai Rijsdijk
3.49.3 2018-11-20 memLayout() optimized parsing (win)
3.49.2 2018-11-19 code cleanup
3.49.1 2018-11-19 cpu().brand removed extra spaces, tabs
3.49.0 2018-11-19 added system uuid() (os specific), versions() added postgresql
3.48.4 2018-11-18 windows: garbled output because of codepage
3.48.3 2018-11-18 dockerContainerStats() fixed issue cpu_percent win
3.48.2 2018-11-18 dockerContainerStats() fixed issue cpu_percent, win exec
3.48.1 2018-11-17 docker...() fixed issue parsing docker socket JSON
3.48.0 2018-11-17 diskLayout() better interface detection (WIN), osInfo() added build, serial
3.47.0 2018-11-06 versions() added docker, postfix
3.46.0 2018-11-05 fixed issue versions(), added system openssl version
3.45.10 2018-11-03 fixed issue battery(), modified package.json - files
3.45.9 2018-10-22 fixed node 4 incompatibility
3.45.8 2018-10-22 system() fix Raspberry Pi detection
3.45.7 2018-10-05 fixed typos
3.45.6 2018-09-12 mem() bug parsing linux in other languages
3.45.5 2018-09-07 diskLayout() tiny bug S.M.A.R.T status windows
3.45.4 2018-09-06 added icon to README.md
3.45.3 2018-09-06 diskLayout() optimized media type detection (HD, SSD) on Windows
3.45.2 2018-09-05 updated imags shields icons
3.45.1 2018-09-05 updated documentation
3.45.0 2018-09-04 diskLayout() added smartStatus
3.44.2 2018-08-28 added code quality badges
3.44.1 2018-08-28 code cleanup
3.44.0 2018-08-25 battery() bugfix & added type, model, manufacturer, serial
3.43.0 2018-08-25 cpuCurrentspeed() added cpu speed for all cores
3.42.10 2018-08-25 processes() optimized start time parsing
3.42.9 2018-08-08 cpuTemperature() optimized parsing
3.42.8 2018-08-03 updated docs
3.42.7 2018-08-03 processes() optimized parsing ps name
3.42.6 2018-08-03 processes() bugfix parsing ps linux
3.42.5 2018-08-03 processes() bugfix parsing ps linux
3.42.4 2018-07-09 cpuTemperature() bugfix parsing negative values
3.42.3 2018-07-05 services() bugfix not finding services with capital letters
3.42.2 2018-07-03 users() optimized results if lack of permissions
3.42.1 2018-07-03 versions() bugfix git version macOS
3.42.0 2018-06-01 processes() added parent process PID
3.41.4 2018-05-28 windows exec WMIC path detection (windows) in try catch
3.41.3 2018-05-13 improved SunOS support getStaticData(), getDynamicData()
3.41.2 2018-05-13 bugfix system() and flags() Raspberry Pi
3.41.1 2018-05-11 updated docs
3.41.0 2018-05-11 system() Raspberry Pi bugfix and extended detection, added partial SunOS support
3.40.1 2018-05-10 bugfix system().sku (windows)
3.40.0 2018-04-29 extended versions() (php, redis, mongodb)
3.39.0 2018-04-29 added versions().mysql and versions().nginx, starting SunOS support (untested)
3.38.0 2018-04-06 added battery().acconnected
3.37.12 2018-04-05 another optimization battery().ischarging for macOS
3.37.11 2018-04-05 another optimization battery().ischarging for macOS
3.37.10 2018-04-05 battery().ischarging optimized for macOS
3.37.9 2018-04-03 optimized processes(), bugfix networkInterfaceDefault()
3.37.8 2018-03-25 optimized networkDefaultInterface() detection, fixed network operstate MacOS
3.37.7 2018-03-13 celebrating 4th birthday
3.37.6 2018-03-12 updated docs: fixed diskLayoutand mamlayout
3.37.5 2018-03-12 added support for ip instead of ifconfig
3.37.4 2018-02-22 bugfix windows processes(), disklayout()
3.37.3 2018-02-19 added windows exec windowsHide option
3.37.2 2018-02-15 fixed bug battery().percent for macOS
3.37.1 2018-02-13 fixed bug battery().ischarging for macOS
3.37.0 2018-02-11 extended FreeBSD support networkStats()
3.36.0 2018-02-11 extended FreeBSD support networkConnections()
3.35.0 2018-02-11 extended FreeBSD support processLoad()
3.34.1 2018-02-11 updated docs
3.34.0 2018-02-10 first partial FreeBSD support
3.33.15 2018-01-21 optimized OSX battery
3.33.14 2018-01-17 bugfix diskLayout() (Windows)
3.33.13 2018-01-12 bugfix memLayout() (Windows)
3.33.12 2017-12-25 fixed typos
3.33.11 2017-12-17 updated docs
3.33.10 2017-12-14 bugfix WMIC path detection (windows) blockDevice parse (Windows 7)
3.33.9 2017-12-14 bugfix WMIC path detection (windows) not found (Windows)
3.33.8 2017-12-02 bugfix diskLayout().size (OSX)
3.33.7 2017-11-28 bugfix diskLayout().size
3.33.6 2017-11-16 bugfix diskLayout().size
3.33.5 2017-11-09 code cleanup
3.33.4 2017-11-09 bugfix graphics controller win (bytes)
3.33.3 2017-11-08 bugfix cpu speed arm - type
3.33.2 2017-11-08 bugfix cpu speed arm
3.33.1 2017-11-07 improved bios and main board information
3.33.0 2017-11-07 added bios and main board information
3.32.4 2017-11-02 AMD cpu base frequencies table also for windows
3.32.3 2017-11-02 code cleanup, AMD cpu base frequencies table
3.32.2 2017-11-01 bugfix JSON.parse error blockDevices()
3.32.1 2017-10-23 updated docs
3.32.0 2017-10-23 extended memLayout() - added manufacturer
3.31.4 2017-10-21 updated README.md
3.31.3 2017-10-21 bugfix graphics(), fixed typo README.md
3.31.2 2017-10-16 bugfix graphics() vendor and model parsing linux VGA/3D
3.31.1 2017-10-16 bugfix graphics() vendor and model parsing linux
3.31.0 2017-10-15 extended windows support cpuFlags() (partially)
3.30.6 2017-10-05 updated community profile
3.30.5 2017-10-05 bugfix users() - parsing values on windows
3.30.4 2017-10-03 bugfix cpuTemperature() - parsing values on windows
3.30.3 2017-10-03 bugfix cpuTemperature() - max value on windows
3.30.2 2017-09-26 bugfix networkInterfaces() - optimized ip6 address selection
3.30.1 2017-09-21 bugfix/typo inetChecksite()
3.30.0 2017-09-21 extended versions() (added yarn, gulp, grunt, tsc, git)
3.29.0 2017-09-15 extended windows support services(), optimized diskLayout() (OSX), bugfixes
3.28.0 2017-09-14 extended windows support processes()
3.27.1 2017-09-13 updated Raspberry version detection system() (Pi 3, Zero)
3.27.0 2017-09-12 added raw data to currentLoad(), fixed networkInterfaces() MAC problem node 8.x
3.26.2 2017-09-01 removed redundant code
3.26.1 2017-08-23 fixed cpu().speed windows / AMD, updated docs
3.26.0 2017-08-21 extended getDynamicData() (windows), updated docs
3.25.1 2017-08-07 updated docs
3.25.0 2017-08-07 improved windows support networkStats(), cpuCache(), bug fix getStaticData()
3.24.0 2017-08-05 extended windows support networkStats(), networkConnections()
3.23.7 2017-07-11 bug fix diskLayout()
3.23.6 2017-07-11 added cpuFlags() to getStaticData(), bug fix graphics() (Win)
3.23.5 2017-06-29 bug fix inetChecksite()
3.23.4 2017-06-24 bug fix getDynamicData(), getAllData() - mem
3.23.3 2017-06-23 updated docs
3.23.2 2017-06-23 bug fix battery (windows)
3.23.1 2017-06-22 updated docs
3.23.0 2017-06-22 added memLayout, diskLayout, extended windows support (inetChecksite)
3.22.0 2017-06-19 extended windows support (users, inetLatency)
3.21.0 2017-06-18 extended time (timezone), extended windows support (battery, getAll…)
3.20.1 2017-06-17 updated docs
3.20.0 2017-06-16 extend WIN support (cpu, cpuCache, cpuCurrentspeed, mem, networkInterfaces, docker)
3.19.0 2017-06-12 OSX temperature now an optional dependency
3.18.0 2017-05-27 extended cpu info (vendor, family, model, stepping, revision, cache, speedmin/max)
3.17.3 2017-04-29 minor fix (blockDevices data array, Windows)
3.17.2 2017-04-24 minor fix (removed console.log)
3.17.1 2017-04-23 fixed bugs fsSize(win), si.processes (command), si.osinfo(win)
3.17.0 2017-02-19 windows support for some first functions, extended process list (linux)
3.16.0 2017-01-19 blockDevices: added removable attribute + fix
3.15.1 2017-01-17 minor cpuTemperature fix (OSX)
3.15.0 2017-01-15 added cpuTemperature also for OSX
3.14.0 2017-01-14 added currentLoad per cpu/core, cpu cache and cpu flags
3.13.0 2016-11-23 added shell (returns standard shell)
3.12.0 2016-11-17 refactoring and extended currentLoad
3.11.2 2016-11-16 blockDevices: improved for older lsblk versions
3.11.1 2016-11-16 fixed small bug in blockDevices
3.11.0 2016-11-15 blockDevices for OSX and extended blockDevices
3.10.2 2016-11-14 bug fix fsSize on OSX
3.10.1 2016-11-14 optimization fsStats, disksIO, networkStats
3.10.0 2016-11-12 added blockDevices, fixed fsSize, added file system type
3.9.0 2016-11-11 added MAC address to networkInterfaces, fixed currentLoad
3.8.1 2016-11-04 updated docs
3.8.0 2016-11-04 added dockerContainerProcesses
3.7.1 2016-11-03 code refactoring
3.7.0 2016-11-02 extended docker stats, and no longer relying on curl
3.6.0 2016-09-14 added versions (kernel, ssl, node, npm, pm2, …)
3.5.1 2016-09-14 bugfix graphics info
3.5.0 2016-09-14 added graphics info (controller, display)
3.4.4 2016-09-02 tiny fixes system.model, getDefaultNetworkInterface
3.4.3 2016-09-02 tiny bug fix fsStats, disksIO OSX
3.4.2 2016-09-01 improved default network interface
3.4.1 2016-08-30 updated docs
3.4.0 2016-08-30 rewritten processes current cpu usage
3.3.0 2016-08-24 process list added to processes
3.2.1 2016-08-19 updated docs, improvement system
3.2.0 2016-08-19 added battery information
3.1.1 2016-08-18 improved system and os detection (vm, …), bugfix disksIO
3.1.0 2016-08-18 added Docker stats
3.0.1 2016-08-17 Bug-Fix disksIO, users, updated docs
3.0.0 2016-08-03 new major version 3.0
2.0.5 2016-03-02 changed .gitignore
2.0.4 2016-02-22 tiny correction - removed double quotes CPU brand, …
2.0.3 2016-02-22 optimized cpuCurrentspeed
2.0.2 2016-02-22 added CoreOS identification
2.0.1 2016-01-07 minor patch
2.0.0 2016-01-07 new major version 2.0
1.0.7 2015-11-27 fixed: si.network_speed()
1.0.6 2015-09-17 fixed: si.users()
1.0.5 2015-09-14 updated dependencies
1.0.4 2015-07-18 updated docs
1.0.3 2015-07-18 bugfix cpu cores
1.0.2 2015-07-18 bugfix cpu_currentspeed, cpu_temperature
1.0.1 2015-07-18 documentation update
1.0.0 2015-07-18 bug-fixes, version bump, published as npm component
0.0.3 2014-04-14 bug-fix (cpu_speed)
0.0.2 2014-03-14 Optimization FS-Speed & CPU current speed
0.0.1 2014-03-13 initial release

Major (breaking) Changes - Version 3

  • works only with node.js v4.0.0 and above (using now internal ES6 promise function, arrow functions, …)
  • Promises. As you can see in the documentation, you can now also use it in a promise oriented way. But callbacks are still supported.
  • Async/Await. Due to the promises support, systeminformation also works perfectly with the async/await pattern (available in node.js v7.6.0 and above). See example in the docs.
  • cpuCurrentspeed: now returns an object with current minimal, maximal and average CPU frequencies of all cores.
  • mem: now supports also newer versions of free (Version 3.3.10 and above); extended information avaliable (potentially available memory)
  • fsStats: added information sum bytes read + write (tx) and sum transfer rate/sec (tx_sec)
  • networkInterfaces: now providing one more detail: internal - true if this is an internal interface like “lo”
  • networkConnections: instead of only counting sockets, you now get an array of objects with connection details for each socket (protocol, local and peer address, state)
  • users: now provides an array of objects with users online including detailed session information (login date/time, ip address, terminal, command)
  • inetLatency: now you can provide a host against which you want to test latency (default is 8.8.8.8)
  • getDynamicData: changed order of parameters (callback - if provided - is now the last one): getDynamicData(srv, network, callback)
  • getAllData: changed order of parameters (callback - if provided - is now the last one): getAllData(srv, network, callback)

New Functions

  • FreeBSD support: for some basic functions (new in version 3.34 ff)
  • diskLayout: returns hard disk layout (new in version 3.23)
  • memLayout: returns memory chip layout (new in version 3.23)
  • Windows support: for some basic functions (new in version 3.17 ff)
  • cpuCache: returns CPU cache (L1, L2, L3) sizes (new in version 3.14)
  • cpuFlags: returns CPU flags (new in version 3.14)
  • currentLoad.cpus: returns current load per cpu/core in an array (new in version 3.14)
  • shell: returns standard shell e.g. /bin/bash (new in version 3.13)
  • blockDevices: returns array of block devices like disks, partitions, raids, roms (new in version 3.10)
  • dockerContainerProcesses: returns processes for a specific docker container (new in version 3.8)
  • versions: returns object of versions - kernel, ssl, node, npm, …(new in version 3.6)
  • graphics: returns arrays of graphics controllers and displays (new in version 3.5)
  • networkInterfaceDefault: returns default network interface (new in version 3.4)
  • processes: now returns also a process list with all process details (new in version 3.3)
  • battery: retrieves battery status and charging level (new in version 3.2)
  • dockerContainers: returns a list of all docker containers (new in version 3.1)
  • dockerContainerStats: returns statistics for a specific docker container (new in version 3.1)
  • dockerAll: returns a list of all docker containers including their stats (new in version 3.1)
  • disksIO: returns overall diskIO and IOPS values for all mounted volumes (new in version 3.0)

Bug Fixes / improvements

  • improvement cpuTemperature - works now also on Raspberry Pi
  • bugfix disksIO - on OSX read and write got mixed up
  • several bug fixes (like assess errors in cpuCurrentspeed, potentially incorrect results in users, …)
  • testet on even more platforms and linux distributions

Be aware, that the new version 3.x is NOT fully backward compatible to version 2.x …

Major (breaking) Changes - Version 2

There had been a lot of changes in version 2 of systeminformation! Here is a quick overview (for those who come from version 1):

New Functions

  • version: returns systeminformation version (semver) of this library
  • system: hardware info (manufacturer, product/model name, version, serial, uuid)
  • networkConnections: number of active connections
  • inetLatency: latency in ms to external resource (internet)
  • getStaticData: returns on json object with static data at once (OS, CPU, Network Interfaces - they should not change until restarted)
  • getDynamicData: returns on json object with all dynamic data at once (e.g. for monitoring agents)
  • getAllData: returns on json object with all data (static and dynamic) at once

Renamed Functions (now all camelCase)

  • osinfo: renamed to osInfo
  • cpu_currentspeed: renamed to cpuCurrentspeed
  • cpu_temperature: renamed to cpuTemperature
  • fs_size: renamed to fsSize
  • fs_speed: renamed to fsStats
  • network_interfaces: renamed to networkInterfaces
  • network_speed: renamed to networkStats
  • network_connections: renamed to networkConnections
  • currentload: renamed to currentLoad
  • fullload: renamed to fullLoad
  • processload: renamed to processLoad
  • checksite: renamed to inetChecksite

Function Changes

  • cpu_temperature/cpuTemperature: -1 is new default (and indicates that non sensors are installed)
  • cpu_temperature/cpuTemperature: new result max which returns max temperature of all cores
  • cpu_currentspeed/cpuCurrentspeed: now in GHz
  • cpu: splitted manufacturer (e.g. Intel) and brand (e.g. Core 2 Duo)
  • network_speed/networkStats: now better support for OS X (also support for operstate)
  • network_speed/networkStats: overall received and transferred bytes (rx, tx)
  • mem: now better support for OS X (also support for swaptotal, swapused, swapfree)
  • fs_size/fsSize: use-values now in % (0 - 100% instead of 0 - 1)
  • fs_speed/fsStats: now also full support for OS X
  • checksite/inetChecksite: new result structure - see command reference
  • checksite/inetChecksite: ms (former response_ms): -1 if not ok

Other changes

  • osx-temperature-sensor: now added as an optional dependency
  • no more external dependencies: request is not longer needed
  • where possible results are now integer or float values (instead of strings) because it is easier to calculate with numbers ;-)