@simongrasinovski/str-utils/dist/randomCharacters.js

A lightweight utility library for effortless string manipulation. Simplify common tasks like case validation, conversion and formatting with easy-to-use functions that enhance your JavaScript applications

"use strict";

function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
var _require = require('./constants'),
  NUMBERS = _require.NUMBERS,
  LOWERCASE_LETTERS = _require.LOWERCASE_LETTERS,
  SYMBOLS = _require.SYMBOLS,
  UPPERCASE_LETTERS = _require.UPPERCASE_LETTERS;

/**
 * Generates a random string of a specified length, with optional character sets (lowercase, uppercase, numbers, symbols).
 *
 * @function
 * @param {number} length - The length of the random string.
 * @param {object} [options={}] - Configuration object to specify the character sets.
 * @param {boolean} [options.lowercase=true] - If true, includes lowercase letters.
 * @param {boolean} [options.uppercase=false] - If true, includes uppercase letters.
 * @param {boolean} [options.numbers=false] - If true, includes numbers.
 * @param {boolean} [options.symbols=false] - If true, includes symbols.
 * @returns {string} Generated random string with selected characters.
 *
 * @example
 * const result = randomCharacters(10);
 * console.log(result); // 'a1b2c3d4e5' (example output)
 */
module.exports = function (length) {
  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
  var lowercase = options.lowercase,
    uppercase = options.uppercase,
    numbers = options.numbers,
    symbols = options.symbols;
  var result = '';
  var characters = [];
  if (lowercase) characters.push.apply(characters, _toConsumableArray(LOWERCASE_LETTERS));
  if (uppercase) characters.push.apply(characters, _toConsumableArray(UPPERCASE_LETTERS));
  if (numbers) characters.push.apply(characters, _toConsumableArray(NUMBERS));
  if (symbols) characters.push.apply(characters, _toConsumableArray(SYMBOLS));
  if (!characters.length) characters.push.apply(characters, _toConsumableArray(LOWERCASE_LETTERS));
  for (var i = 0; i < length; i++) {
    var randomIndex = Math.floor(Math.random() * characters.length);
    result += characters[randomIndex];
  }
  return result;
};