Miss any of our Open RFC calls?Watch the recordings here! »

custom-random-id

1.0.1 • Public • Published

custom-random-id

A highly customizable JavaScript library that generates random IDs based on the required format. It uses the {{id_specification}} format to generate the kind of ID with varying length number or string or alpha-numeric string

Solves the problem of writing custom algorithms of generating random IDs of numbers or strings or alpha-numeric string. You can even generate a random phone number like +1-541-754-3010 or random anything in your desired format!

Installation

npm install custom-random-id

  • Small in size.
  • Fast. Better performance than most of the other ID generators.
  • URL safe characters. it uses only URL safe characters as it uses only numbers or capital letters or uuids to generate the IDs.
  • Client & Server. Can be used in client side and server side JavaScript applications.

Usage

const { IdGenerator } = require("custom-random-id");
// To generate a 5 digit random number
const ID = new IdGenerator("{{ number_5 }}");
let id = ID.getFinalExpression();
console.log(id); // => 56412
 
// To generate a 10 character random string
const ID = new IdGenerator("{{ string_10 }}");
let id = ID.getFinalExpression(); // => HYIOMNTRSJ
 
// To generate a 8 character random alpha numeric
const ID = new IdGenerator("{{ alpha_number_10 }}");
let id = ID.getFinalExpression(); // => JU78BH98
 
// To generate a uuid
const ID = new IdGenerator("{{ uuid }}");
let id = ID.getFinalExpression(); // => 5bc787b8-00ac-49ea-a970-2fca9ec737af

Format

Format: "{{ type_count }}" where type and count are 2 separate entities. The whole expression has to be provided in string format only. Eg: "{{ number_10 }}"

  • type

    • string: Generates a string of the specified length.
    • number: Generates a number (integer) of a specified length.
    • alpha_number: Generates an alpha-numeric string (string of numbers and characters in caps) of a specified length.
    • uuid: Generates an uuid.
  • count: An integer number for the number of digits/characters to be present in the generated string.

Examples:
"{{ string_10 }}";
// output: VVMTINCMBC
"{{ string_50 }}";
// output: OTXITFCVIPNFTIERWXPOURNUSMDOFPCAUHJBIVZFWPEQWTMMPW
"{{ string_1 }}";
// output: K
// Single random Char
"{{ number_15 }}";
// output: 234112942672429
"{{ number_1 }}";
// output: 4
// This can be used to get a single random number
"{{ alpha_number_10 }}";
// output: KHT5N52J36
// To get a string having upper case characters and integer numbers
"{{ alpha_number_10 }}";
// output: KHT5N52J36
// To get a string having upper case characters and integer numbers
"{{ uuid }}";
// output: 43a629cf-661b-4d4c-b66e-16e6714f8732
// To get an unique string every time.

Creative Usage

Unlock your creativity by using the custom-random-id generator to generate strings of any required format by using multiple expressions in a string.

Generate an American Phone number
"+1 {{number_3}}-{{number_3}}-{{number_4}}";
// output: +1 941-626-2929
Generate phone numbers starting with only '7'
"+1 7{{number_2}}-{{number_3}}-{{number_4}}";
// output: +1 785-587-6616
Generate a string with 5 characters in the start and 5 numbers in the end
"{{string_5}}{{number_5}}";
// output: LPDZW86423
Generate a string like a gun name
"AK-{{number_2}}";
// output: AK-35
// output: AK-87
// output: AK-47
// .. etc
Generate a string with alternating character, number of length 5
"{{string_1}}{{number_1}}{{string_1}}{{number_1}}{{string_1}}";
// output: X9K5L
// output: E6S4W
Or any random combination like
"{{uuid}}---{{number_5}}---{{string_10}}";
// output: c1ed245a-18cb-4e8b-ad2f-db67f8fa4e09---68864---ULXCAKACQE

Install

npm i custom-random-id

DownloadsWeekly Downloads

10

Version

1.0.1

License

MIT

Unpacked Size

13.1 kB

Total Files

5

Last publish

Collaborators

  • avatar