Id-generators NPM

id-generators

id-generators is small JavaScript library to generate ID with awesome Unique ID libraries.

Installation

npm install id-generators

Usages

const generators = require("id-generators");
const generator = generators.get("nanoid");
const generate = generator();

console.log("ID: " + generate());
// ID: gCa0wL_8ElTje5cwOci1d
console.log("ID: " + generate());
// ID: 5C_YAjgQl4iM3zK-TValY
console.log("ID: " + generate());
// ID: gQOOwCoQyfCuGK7fgINLd

If you want to customize ID, you can pass an option as an argument to the generator function.

const generators = require("id-generators");
const generator = generators.get("nanoid-simple");
const generate = generator({ size: 25 });

console.log("ID: " + generate());
// ID: oa9wj0kfm50gv2qse8l5xup0u
console.log("ID: " + generate());
// ID: xn5ff5odiylg4jehhhp9vtlxv
console.log("ID: " + generate());
// ID: dff7ay5x38k1pkc2pxjv7elky

generator type	ID length	character set	options/default	description
cuid (default)	25	`a-z0-9`, start with `c`		use `cuid()` generated string. e.g. `ck2bi7fxf00013ryng5jr1rer`
cuid-slug	7-10	`a-z0-9`		use `cuid.slug()` generated string. e.g. `xh23npi`
nanoid /nanoid-good	21	`A-Za-z0-9_-`	size/21	use `nanoid()` or `nanoid-good` generated string. e.g. `EwUTt2eoka-oEV5kf-o0O`
nanoid-simple /nanoid-simple-good	24	`a-z0-9`	size/24	use `nanoid/generate` or `nanoid-good/generate` generated string. e.g. `pfldm3gg8h9psydphotqe71d`
nanoid-lowercase /nanoid-lowercase-good	26	`a-z`	size/26	use `nanoid/generate` or `nanoid-good/generate` generated string. e.g. `jsjxoibprplrdoitjmppotjrnm`

If use nanoid-good or nanoid-xxx-good, you should install nanoid-good manually.
npm install nanoid-good

Define Custom Generators

This sample shows how to register a generator function. The generator function should return a function that returns a ID.

const { register } = require("id-generators");

register("my_custom_id", function (option) {
  option = option || {};
  let size = option.size || 8;
  let prefix = option.prefix || "items-";
  return function (title) {
    return (
      prefix + title.toLowerCase().replace(/[^\w]/g, "").substring(0, size)
    );
  };
});

const generators = require("id-generators");
const generator = generators.get("my_custom_id");
const generate = generator({ size: 6 });

console.log("ID: " + generate("Hello World!"));
// ID: items-hellow
console.log("ID: " + generate("Foo Bar!"));
// ID: items-foobar

Awesome Unique ID - A curated list of awesome Unique ID libraries and resources.
cuid - Collision-resistant ids optimized for horizontal scaling and binary search lookup performance.
nanoid - A tiny, secure, URL-friendly, unique string ID generator for JavaScript.
nanoid-good - Guarantees you will not get any obscene words or other profanity in your ids generated by Nano ID.