passwd-user
Get the passwd user entry from a username or user identifier (UID)
Works on macOS and Linux. See user-info
if you need cross-platform support.
Install
npm install passwd-user
Usage
import {passwdUser} from 'passwd-user';
console.log(await passwdUser('sindresorhus'));
/*
{
username: 'sindresorhus',
password: '*',
userIdentifier: 501,
groupIdentifier: 20,
fullName: 'Sindre Sorhus',
homeDirectory: '/home/sindresorhus',
shell: '/bin/zsh'
}
*/
await passwdUser(501);
console.log('Got entry for user 501');
const user = await passwdUser();
console.log(`Got entry for user ${user.userIdentifier}`);
API
Returns an object with:
username
password
userIdentifier
: UID
groupIdentifier
: GID
fullName
: Name of user
homeDirectory
: Home directory
shell
: Default shell
passwdUser(username?)
passwdUser(userIdentifier?)
Returns a Promise<object>
with the user entry.
passwdUserSync(username?)
passwdUserSync(userIdentifier?)
Returns an object
with the user entry.
username
Type: string
The username to look up.
userIdentifier
Type: number
Default: process.getuid()
(The current user)
The user identifier (UID) to look up.
Related
- username - Get the user's username (cross-platform)
- fullname - Get the user's fullname (cross-platform)