gerador-br/dist/mjs/utils.mjs

Gerador de Dados Fictícios - Brasil

import { siglasEstados } from './data/db-general.mjs';

/**
 * Retorna um número inteiro aleatório entre min (inclusive) e max (exclusivo).
 * @param {number} min - O limite inferior (inclusivo).
 * @param {number} max - O limite superior (exclusivo).
 * @returns {number} Um número inteiro aleatório entre min e max.
 */
const randomInt = (min, max) => {
  return Math.floor(Math.random() * (max - min)) + min;
};

/**
 * Retorna um elemento aleatório de um array.
 * @param {Array} arr - O array do qual deve ser extraído um elemento aleatório.
 * @returns {*} Um elemento aleatório do array.
 */
const getRandom = (arr) => {
  const index = randomInt(0, arr.length); // Gera um índice aleatório no intervalo do array
  return arr[index];
};

/**
 * Uma sigla de estado aleatória.
 * @type {string}
 * @example
 * console.log(stateRand); // Retorna qualquer sigla de estado, como "SP", "RJ", etc.
 */
const stateRand = getRandom(siglasEstados);

export { getRandom, randomInt, stateRand };