Skip to main content
Process.cpuUsage - process - Node documentation
method Process.cpuUsage

Usage in Deno

import { type Process } from "node:process";
Process.cpuUsage(previousValue?: CpuUsage): CpuUsage

The process.cpuUsage() method returns the user and system CPU time usage of the current process, in an object with properties user and system, whose values are microsecond values (millionth of a second). These values measure time spent in user and system code respectively, and may end up being greater than actual elapsed time if multiple CPU cores are performing work for this process.

The result of a previous call to process.cpuUsage() can be passed as the argument to the function, to get a diff reading.

import { cpuUsage } from 'node:process';

const startUsage = cpuUsage();
// { user: 38579, system: 6986 }

// spin the CPU for 500 milliseconds
const now = Date.now();
while (Date.now() - now < 500);

console.log(cpuUsage(startUsage));
// { user: 514883, system: 11226 }

Parameters

optional
previousValue: CpuUsage

A previous return value from calling process.cpuUsage()

Return Type

Back to top