Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

username

sindresorhus1.7mMIT7.0.0TypeScript support: included

Get the username of the current user

username, user, login, name, logname, lname, whoami, shell, env, environment, variable

readme

username

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

import {username} from 'username';

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(): Promise<string | undefined>

Returns the username.

usernameSync(): string | undefined

Returns the username.