Skip to content

Exports

[<Class>]
type Exports =
    static member EOL: string
    static member constants: Constants4
    static member devNull: string
    static member ``type`` () : string
    static member arch () : string
    static member availableParallelism () : float
    static member cpus () : CpuInfo array
    static member endianness () : Result
    static member freemem () : float
    static member getPriority (?pid: float) : float
    static member homedir () : string
    static member hostname () : string
    static member loadavg () : float array
    static member machine () : string
    static member networkInterfaces () : Dict<NetworkInterfaceInfo array>
    static member platform () : Platform
    static member release () : string
    static member setPriority (pid: float, priority: float) : unit
    static member setPriority (priority: float) : unit
    static member tmpdir () : string
    static member totalmem () : float
    static member uptime () : float
    static member userInfo (options: UserInfoOptions) : UserInfo<U2<string,Buffer<U2<ArrayBuffer,SharedArrayBuffer>>>>
    static member userInfo (options: UserInfoOptionsWithBufferEncoding) : UserInfo<NonSharedBuffer>
    static member userInfo (?options: UserInfoOptionsWithStringEncoding) : UserInfo<string>
    static member version () : string
AssemblyXantham.Fable.Node
Attributes[<Erase>]

The package's value exports, each bound to its import.

Properties

static member EOL: string

The operating system-specific end-of-line marker.

  • \n on POSIX
  • \r\n on Windows
static member constants: Constants4
static member devNull: string

Methods

static member ``type`` () : string

Returns the operating system name as returned by uname(3). For example, it returns 'Linux' on Linux, 'Darwin' on macOS, and 'Windows_NT' on Windows.

See https://en.wikipedia.org/wiki/Uname#Examples for additional information about the output of running uname(3) on various operating systems.

@since v0.3.3

static member arch () : string

Returns the operating system CPU architecture for which the Node.js binary was compiled. Possible values are 'arm', 'arm64', 'ia32', 'loong64', 'mips', 'mipsel', 'ppc', 'ppc64', 'riscv64', 's390', 's390x', and 'x64'.

The return value is equivalent to process.arch.

@since v0.5.0

static member availableParallelism () : float

Returns an estimate of the default amount of parallelism a program should use. Always returns a value greater than zero.

This function is a small wrapper about libuv's uv_available_parallelism().

@since v19.4.0, v18.14.0

static member cpus () : CpuInfo array

Returns an array of objects containing information about each logical CPU core. The array will be empty if no CPU information is available, such as if the /proc file system is unavailable.

The properties included on each object include:

[
{
model: 'Intel(R) Core(TM) i7 CPU         860  @ 2.80GHz',
speed: 2926,
times: {
user: 252020,
nice: 0,
sys: 30340,
idle: 1070356870,
irq: 0,
},
},
{
model: 'Intel(R) Core(TM) i7 CPU         860  @ 2.80GHz',
speed: 2926,
times: {
user: 306960,
nice: 0,
sys: 26980,
idle: 1071569080,
irq: 0,
},
},
{
model: 'Intel(R) Core(TM) i7 CPU         860  @ 2.80GHz',
speed: 2926,
times: {
user: 248450,
nice: 0,
sys: 21750,
idle: 1070919370,
irq: 0,
},
},
{
model: 'Intel(R) Core(TM) i7 CPU         860  @ 2.80GHz',
speed: 2926,
times: {
user: 256880,
nice: 0,
sys: 19430,
idle: 1070905480,
irq: 20,
},
},
]

nice values are POSIX-only. On Windows, the nice values of all processors are always 0.

os.cpus().length should not be used to calculate the amount of parallelism available to an application. Use availableParallelism for this purpose.

@since v0.3.3

static member endianness () : Result

Returns a string identifying the endianness of the CPU for which the Node.js binary was compiled.

Possible values are 'BE' for big endian and 'LE' for little endian.

@since v0.9.4

static member freemem () : float

Returns the amount of free system memory in bytes as an integer.

@since v0.3.3

static member getPriority (?pid: float) : float

Returns the scheduling priority for the process specified by pid. If pid is not provided or is 0, the priority of the current process is returned.

@since v10.10.0

Parameter
pidThe process ID to retrieve scheduling priority for.
static member homedir () : string

Returns the string path of the current user's home directory.

On POSIX, it uses the $HOME environment variable if defined. Otherwise it uses the effective UID to look up the user's home directory.

On Windows, it uses the USERPROFILE environment variable if defined. Otherwise it uses the path to the profile directory of the current user.

@since v2.3.0

static member hostname () : string

Returns the host name of the operating system as a string.

@since v0.3.3

static member loadavg () : float array

Returns an array containing the 1, 5, and 15 minute load averages.

The load average is a measure of system activity calculated by the operating system and expressed as a fractional number.

The load average is a Unix-specific concept. On Windows, the return value is always [0, 0, 0].

@since v0.3.3

static member machine () : string

Returns the machine type as a string, such as arm, arm64, aarch64, mips, mips64, ppc64, ppc64le, s390, s390x, i386, i686, x86_64.

On POSIX systems, the machine type is determined by calling uname(3). On Windows, RtlGetVersion() is used, and if it is not available, GetVersionExW() will be used. See https://en.wikipedia.org/wiki/Uname#Examples for more information.

@since v18.9.0, v16.18.0

static member networkInterfaces () : Dict<NetworkInterfaceInfo array>

Returns an object containing network interfaces that have been assigned a network address.

Each key on the returned object identifies a network interface. The associated value is an array of objects that each describe an assigned network address.

The properties available on the assigned network address object include:

{
lo: [
{
address: '127.0.0.1',
netmask: '255.0.0.0',
family: 'IPv4',
mac: '00:00:00:00:00:00',
internal: true,
cidr: '127.0.0.1/8'
},
{
address: '::1',
netmask: 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff',
family: 'IPv6',
mac: '00:00:00:00:00:00',
scopeid: 0,
internal: true,
cidr: '::1/128'
}
],
eth0: [
{
address: '192.168.1.108',
netmask: '255.255.255.0',
family: 'IPv4',
mac: '01:02:03:0a:0b:0c',
internal: false,
cidr: '192.168.1.108/24'
},
{
address: 'fe80::a00:27ff:fe4e:66a1',
netmask: 'ffff:ffff:ffff:ffff::',
family: 'IPv6',
mac: '01:02:03:0a:0b:0c',
scopeid: 1,
internal: false,
cidr: 'fe80::a00:27ff:fe4e:66a1/64'
}
]
}

@since v0.6.0

static member platform () : Platform

Returns a string identifying the operating system platform for which the Node.js binary was compiled. The value is set at compile time. Possible values are 'aix', 'darwin', 'freebsd', 'linux', 'openbsd', 'sunos', and 'win32'.

The return value is equivalent to process.platform.

The value 'android' may also be returned if Node.js is built on the Android operating system. Android support is experimental.

@since v0.5.0

static member release () : string

Returns the operating system as a string.

On POSIX systems, the operating system release is determined by calling uname(3). On Windows, GetVersionExW() is used. See https://en.wikipedia.org/wiki/Uname#Examples for more information.

@since v0.3.3

static member setPriority (pid: float, priority: float) : unit

Attempts to set the scheduling priority for the process specified by pid. If pid is not provided or is 0, the process ID of the current process is used.

The priority input must be an integer between -20 (high priority) and 19 (low priority). Due to differences between Unix priority levels and Windows priority classes, priority is mapped to one of six priority constants in os.constants.priority. When retrieving a process priority level, this range mapping may cause the return value to be slightly different on Windows. To avoid confusion, set priority to one of the priority constants.

On Windows, setting priority to PRIORITY_HIGHEST requires elevated user privileges. Otherwise the set priority will be silently reduced to PRIORITY_HIGH.

@since v10.10.0

Parameter
pidThe process ID to set scheduling priority for.
priorityThe scheduling priority to assign to the process.
static member setPriority (priority: float) : unit

Attempts to set the scheduling priority for the process specified by pid. If pid is not provided or is 0, the process ID of the current process is used.

The priority input must be an integer between -20 (high priority) and 19 (low priority). Due to differences between Unix priority levels and Windows priority classes, priority is mapped to one of six priority constants in os.constants.priority. When retrieving a process priority level, this range mapping may cause the return value to be slightly different on Windows. To avoid confusion, set priority to one of the priority constants.

On Windows, setting priority to PRIORITY_HIGHEST requires elevated user privileges. Otherwise the set priority will be silently reduced to PRIORITY_HIGH.

@since v10.10.0

Parameter
pidThe process ID to set scheduling priority for.
priorityThe scheduling priority to assign to the process.
static member tmpdir () : string

Returns the operating system's default directory for temporary files as a string.

@since v0.9.9

static member totalmem () : float

Returns the total amount of system memory in bytes as an integer.

@since v0.3.3

static member uptime () : float

Returns the system uptime in number of seconds.

@since v0.3.3

static member userInfo (options: UserInfoOptions) : UserInfo<U2<string,Buffer<U2<ArrayBuffer,SharedArrayBuffer>>>>

Returns information about the currently effective user. On POSIX platforms, this is typically a subset of the password file. The returned object includes the username, uid, gid, shell, and homedir. On Windows, the uid and gid fields are -1, and shell is null.

The value of homedir returned by os.userInfo() is provided by the operating system. This differs from the result of os.homedir(), which queries environment variables for the home directory before falling back to the operating system response.

Throws a SystemError if a user has no username or homedir.

@since v6.0.0

static member userInfo (options: UserInfoOptionsWithBufferEncoding) : UserInfo<NonSharedBuffer>

Returns information about the currently effective user. On POSIX platforms, this is typically a subset of the password file. The returned object includes the username, uid, gid, shell, and homedir. On Windows, the uid and gid fields are -1, and shell is null.

The value of homedir returned by os.userInfo() is provided by the operating system. This differs from the result of os.homedir(), which queries environment variables for the home directory before falling back to the operating system response.

Throws a SystemError if a user has no username or homedir.

@since v6.0.0

static member userInfo (?options: UserInfoOptionsWithStringEncoding) : UserInfo<string>

Returns information about the currently effective user. On POSIX platforms, this is typically a subset of the password file. The returned object includes the username, uid, gid, shell, and homedir. On Windows, the uid and gid fields are -1, and shell is null.

The value of homedir returned by os.userInfo() is provided by the operating system. This differs from the result of os.homedir(), which queries environment variables for the home directory before falling back to the operating system response.

Throws a SystemError if a user has no username or homedir.

@since v6.0.0

static member version () : string

Returns a string identifying the kernel version.

On POSIX systems, the operating system release is determined by calling uname(3). On Windows, RtlGetVersion() is used, and if it is not available, GetVersionExW() will be used. See https://en.wikipedia.org/wiki/Uname#Examples for more information.

@since v13.11.0, v12.17.0