randkey
Dead simple JS module to generate random id/key/hash in various formats, including valid UUID v4.
Installation
CDN
<script src="https://unpkg.com/randkey"></script>
NPM
npm i -S randkey
Yarn
yarn add randkey
Snipacks
snipacks add unpkg rk.js randkey
Usage
ES6
import randkey from 'randkey'
CommonJS
let randkey = require('randkey')
AMD
require(['randkey'], randkey => {
//codes go here
})
Global
If you add a script
tag to your HTML, randkey
object will be global available.
Methods
randkey.rand(n)
a random number or string by operations witn Math.random()
and Date.now()
.
The n
optional argument must to be a number from 2 to 36 to be used with toString(n)
. Any other values will be ignored.
If a valid n
was provided, the method will return a string, else will return a number.
randkey.rand() // 555847878175
randkey.rand(2) // '1001010000010000000001111111010100000110'
randkey.rand(8) // '2036103777231'
randkey.rand(16) // '12a82628ee7'
randkey.rand(32) // '18vq5b2hq'
randkey.rand(36) // 'fdqlsnvb'
Deprecation note: the old methods rand16()
, rand32()
and rand36()
was deprecated in favour to rand(n)
.
randkey.id4bits()
hexadecimal number as string with 4 chars.
randkey.id4bits() // 'f9c1'
randkey.id8bits()
hexadecimal number as string with 8 chars.
randkey.id8bits() // 'bf9c61ed'
randkey.id16bits()
hexadecimal number as string with 16 chars.
randkey.id16bits() // '6c1f3ac8e0ba611d'
randkey.id32bits()
hexadecimal number as string with 32 chars.
randkey.id32bits() // 'f17e3ac8e0ba925a61ed19016c1f2eb0'
randkey.id64bits()
hexadecimal number as string with 64 chars.
randkey.id64bits() // 'f17e3ac8e0ba925a61ed19016c1f2eb0f17e3ac8e0ba925a61ed19016c1f2eb0'
randkey.uuid()
Valid UUID v4 string.
randkey.uuid() // 'c30663ff-a2d3-4e5d-b377-9e561e8e599b'