username ![Build Status](https://camo.githubusercontent.com/f15a65f09fb19a157979be9b56c55802c9870a4b120679ea8e60621424a2e062/68747470733a2f2f7472617669732d63692e636f6d2f73696e647265736f726875732f757365726e616d652e7376673f6272616e63683d6d6173746572)
Get the username of the current user
This module is meant for informational purposes and not for secure identification.
Install
$ npm install username
This package only works in Node.js, not in browsers.
Usage
const username = require('username');
(async () => {
console.log(await username());
//=> 'sindresorhus'
})();
API
It first tries to get the username from the SUDO_USER
LOGNAME
USER
LNAME
USERNAME
environment variables. Then falls back to $ id -un
on macOS / Linux and $ whoami
on Windows, in the rare case none of the environment variables are set. The result is cached.
username()
Returns a Promise<string>
with the username.
username.sync()
Returns the username.
Related
- username-cli - CLI for this module
- fullname - Get the fullname of the current user