VOOZH about

URL: https://www.geeksforgeeks.org/node-js/node-js-os-userinfo-method/

⇱ Node.js | os.userInfo() Method - GeeksforGeeks


  • Courses
  • Tutorials
  • Interview Prep

Node.js | os.userInfo() Method

Last Updated : 28 Apr, 2025

The os.userInfo() method is an inbuilt application programming interface of the os module which is used to get the information of currently effective user.

Syntax: 

os.userInfo( options )

Parameters: This method accepts single parameter options which is optional parameter. It specifies the process options to be passed, and an object which contains encoding as a parameter returns. 

  • encoding: It specifies the character encoding for returned data. If it is set to 'buffer', then username, shell, homedir values will be buffer instances. Default value is 'utf8'.

Return Value: It returns an object that specifies the information about the current effective user, which contains username, uid, gid, shell, homedir like values.

Note: On POSIX platform, this is generally a subset of password file contains username, uid, gid, shell, and homedir. Windows shell is set to null and uid, gid are -1.

Below examples illustrate the use of os.userInfo() in Node.js:

Example 1: 

Output: 

{ uid: -1,
 gid: -1,
 username: 'gekcho',
 homedir: 'C:\\Users\\gekcho',
 shell: null }


Example 2: 

Output: 

{ uid: -1,
 gid: -1,
 username: <Buffer 6d 75 6b 75 6c>,
 homedir: <Buffer 43 3a 5c 55 73 65 72 73 5c 6d 75 6b 75 6c>,
 shell: null }

Note: The above program will compile and run by using the node filename.js command.

Reference: https://nodejs.org/api/os.html#os_os_userinfo_options 

Comment

Explore