Skip to content

muhashi/generate-random-username

Repository files navigation

generate-random-username

A tiny package to generate a random username from a list of adjectives and animals.

The wordlist has been manually reviewed to ensure the words are appropriate for use in a username.

Options exist for a custom separator between the username, adding random digits, and capitalizing the words in the username.

Install

npm install generate-random-username

Usage

import generateRandomUsername from 'generate-random-username';

generateRandomUsername();
//=> 'humble-shrew'

generateRandomUsername({ capitalize: true });
//=> 'Witty-Camel'

generateRandomUsername({ separator: '_' });
//=> 'safe_llama'

generateRandomUsername({ digits: 3, capitalize: true });
//=> 'Unaffected-Cat-184'

CommonJS

You can require this module as a CommonJS module.

const generateRandomUsername = require('generate-random-username');

API

generateRandomUsername(options?)

options

Type: object

capitalize

Type: boolean
Default: false

Whether to capitalize each word used in the username.

separator

Type: string
Default: '-'

Separator to use between words in the username.

digits

Type: number
Default: 0

Number of random digits to append to end of username. Must be between 0 and 15 inclusive.