Skip to main content

randomInt

function randomInt
Jump to headingrandomInt(max: number): number

Return a random integer n such that min <= n < max. This implementation avoids modulo bias.

The range (max - min) must be less than 2**48. min and max must be safe integers.

If the callback function is not provided, the random integer is generated synchronously.

// Asynchronous
const {
  randomInt,
} = await import('node:crypto');

randomInt(3, (err, n) => {
  if (err) throw err;
  console.log(`Random number chosen from (0, 1, 2): ${n}`);
});

// Synchronous
const {
  randomInt,
} = await import('node:crypto');

const n = randomInt(3);
console.log(`Random number chosen from (0, 1, 2): ${n}`);

// With `min` argument
const {
  randomInt,
} = await import('node:crypto');

const n = randomInt(1, 7);
console.log(`The dice rolled: ${n}`);

Parameters Jump to heading

Jump to headingmax: number

End of random range (exclusive).

Return Type Jump to heading

number
Jump to headingrandomInt(
min: number,
max: number,
): number

Parameters Jump to heading

Jump to headingmin: number
Jump to headingmax: number

Return Type Jump to heading

number
Jump to headingrandomInt(
max: number,
callback: (
err: Error | null,
value: number,
) => void,
): void

Parameters Jump to heading

Jump to headingmax: number
Jump to headingcallback: (
err: Error | null,
value: number,
) => void

Return Type Jump to heading

void
Jump to headingrandomInt(
min: number,
max: number,
callback: (
err: Error | null,
value: number,
) => void,
): void

Parameters Jump to heading

Jump to headingmin: number
Jump to headingmax: number
Jump to headingcallback: (
err: Error | null,
value: number,
) => void

Return Type Jump to heading

void
Back to top