Configurable human readable id generator for the browser
npm install human-readable-ids-browserA tiny library for generating human readable IDs in the browser.
This library creates ids which are:
- Readable to humans: all words simple valid words in the english language
- Audibly unambigous: simple words are used which do not sound like other words, so that they can be read aloud and entered by other humans
- Clean: no profanity
To generate, we use json files containing animals and adjectives (values/animals.json, values/adjectives.json). Using the built in JS random function, two words are selected and joined with either the default delimiter ('-'), or a custom one if passed.
This library was based on the great work at https://git.coolaj86.com/coolaj86/human-readable-ids.js#readme and follows the same principles - but re-written for the browser instead of requiring bower to transpile.
This library is compatible with TypeScript and JavaScript. Type definitions are included.
``typescript`
const id = getID();
// -> angry-dodo
A delimiter can be passed to the configuration options:
`typescript
const id = getID({ delimiter: '^' });
// -> angry^dodo
const id = getID({ delimiter: ' ' });
// -> angry dodo
`
A number range in the format [min, max] can be passed to the withNumberRange configuration option.
The lower bound (min) is inclusive, and the upper bound (max) is exclusive.
`typescript
const id = getID({ withNumberRange: [0, 100]});
// -> angry-dodo-0 up to angry-dodo-99 (not inc 100)
const id = getID({ delimiter: withNumberRange: [0, 1000]});
// -> angry dodo-0 up to angry-dodo-999 (not inc 1000)
`
---
For development, you will only need Node.js and npm.
#### Node installation on Windows
Just go on official Node.js website and download the installer.
Also, be sure to have git available in your PATH, npm` might need it (You can find git here).
#### Node installation on Ubuntu
You can install nodejs and npm easily with apt install, just run the following commands.
$ sudo apt install nodejs
$ sudo apt install npm
#### Other Operating Systems
You can find more information about the installation on the official Node.js website and the official NPM website.
If the installation was successful, you should be able to run the following command.
$ node --version
v12.4.0
$ npm --version
6.9.0
$ git clone https://github.com/MattAlan-io/human-readable-ids-browser
$ cd human-readable-ids-browser
$ npm install
$ npm run build
$ npm test
PRs welcome!