Skip to main content
userInfo - os - Node documentation
function userInfo

Usage in Deno

import { userInfo } from "node:os";
userInfo(options: { encoding: "buffer"; }): UserInfo<Buffer>

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.

Parameters

options: { encoding: "buffer"; }

Return Type

UserInfo<Buffer>
userInfo(options?: { encoding: BufferEncoding; }): UserInfo<string>

Parameters

optional
options: { encoding: BufferEncoding; }

Return Type

UserInfo<string>