Commit | Line | Data |
---|---|---|
343cfe4f JB |
1 | const crypto = require('crypto') |
2 | ||
3 | /** | |
4 | * Generate a cryptographically secure random number in the [0,1[ range | |
5 | * | |
6 | * @returns | |
7 | */ | |
8 | function secureRandom () { | |
9 | return crypto.randomBytes(4).readUInt32LE() / 0x100000000 | |
10 | } | |
11 | ||
e9bfc28e JB |
12 | /** |
13 | * @param max | |
14 | * @param min | |
7fd91296 | 15 | * @returns |
e9bfc28e | 16 | */ |
f10b1da0 | 17 | function generateRandomInteger (max = Number.MAX_SAFE_INTEGER, min = 0) { |
343cfe4f JB |
18 | if (max < 0) { |
19 | throw new RangeError('Invalid interval') | |
20 | } | |
21 | max = Math.floor(max) | |
da504870 | 22 | if (min != null && min !== 0) { |
343cfe4f JB |
23 | if (max < min || min < 0) { |
24 | throw new RangeError('Invalid interval') | |
25 | } | |
26 | min = Math.ceil(min) | |
27 | return Math.floor(secureRandom() * (max - min + 1)) + min | |
ed2968f2 | 28 | } |
343cfe4f | 29 | return Math.floor(secureRandom() * (max + 1)) |
ed2968f2 JB |
30 | } |
31 | ||
ed40d2b0 JB |
32 | /** |
33 | * | |
34 | * @param size | |
35 | * @param max | |
feb629fe | 36 | * @param numberGenerator |
67bc7194 | 37 | * @returns |
ed40d2b0 | 38 | */ |
feb629fe JB |
39 | function generateRandomNumberArray ( |
40 | size, | |
41 | max = Number.MAX_VALUE, | |
42 | numberGenerator = generateRandomFloat | |
43 | ) { | |
44 | const array = [] | |
ed40d2b0 | 45 | for (let i = 0; i < size; i++) { |
feb629fe | 46 | array.push(numberGenerator(max)) |
ed40d2b0 | 47 | } |
feb629fe JB |
48 | return array |
49 | } | |
50 | ||
51 | /** | |
52 | * | |
53 | * @param max | |
54 | * @param min | |
55 | * @param negative | |
67bc7194 | 56 | * @returns |
feb629fe JB |
57 | */ |
58 | function generateRandomFloat (max = Number.MAX_VALUE, min = 0, negative = true) { | |
59 | if (max < min || min < 0 || max < 0) { | |
60 | throw new RangeError('Invalid interval') | |
61 | } | |
62 | const randomPositiveFloat = crypto.randomBytes(4).readUInt32LE() / 0xffffffff | |
63 | const sign = negative && randomPositiveFloat < 0.5 ? -1 : 1 | |
64 | return sign * (randomPositiveFloat * (max - min) + min) | |
ed40d2b0 JB |
65 | } |
66 | ||
a9c78d5d JB |
67 | /** |
68 | * @param ms | |
7fd91296 | 69 | * @returns |
a9c78d5d JB |
70 | */ |
71 | async function sleep (ms) { | |
72 | return new Promise(resolve => setTimeout(resolve, ms)) | |
73 | } | |
74 | ||
ed2968f2 JB |
75 | const LIST_FORMATTER = new Intl.ListFormat('en-US', { |
76 | style: 'long', | |
77 | type: 'conjunction' | |
78 | }) | |
79 | ||
ed40d2b0 JB |
80 | module.exports = { |
81 | generateRandomInteger, | |
feb629fe JB |
82 | generateRandomFloat, |
83 | generateRandomNumberArray, | |
ed40d2b0 JB |
84 | sleep, |
85 | secureRandom, | |
86 | LIST_FORMATTER | |
87 | } |