KernDX

Appearance

UTIL_Random ​

Class · Group: Utilities

apex
global inherited sharing class UTIL_Random

Generates random values across multiple data types for testing and development, including numbers, strings, UUIDs, and mock Salesforce IDs.

Example

apex
String uuid = UTIL_Random.randomUUID();
String email = UTIL_Random.randomEmail();
Integer number = UTIL_Random.nextInteger(1, 100);
Id mockAccountId = UTIL_Random.randomId(Account.SObjectType);

Methods ​

MethodDescription
global static Boolean nextBoolean()Produces a random boolean by mapping a binary integer result to true or false.
global static Integer nextInteger(Integer upperBound)Produces a random integer from zero up to the given ceiling.
global static Integer nextInteger(Integer lowerBound, Integer upperBound)Produces a random integer between the specified floor and ceiling, both inclusive.
global static String random(Integer length)Builds a random string of the requested length from the printable ASCII character set (codes 32-126).
global static String random(Integer length, String characterSet)Builds a random string of the requested length by sampling from the supplied character set.
global static String randomAlphabetic(Integer length)Builds a random string of the requested length using only Latin letters (a-z, A-Z).
global static String randomAlphanumeric(Integer length)Builds a random string of the requested length using Latin letters and decimal digits (a-z, A-Z, 0-9).
global static Date randomDate()Produces a random date falling between the Unix epoch (1970-01-01) and the current day.
global static Datetime randomDateTime()Produces a random datetime falling between the Unix epoch (1970-01-01) and the current moment.
global static Decimal randomDecimal()Produces a random decimal value with two digits after the decimal point.
global static Decimal randomDecimal(Integer scale)Produces a random decimal with a standard digit count and the caller-specified fractional precision.
global static Decimal randomDecimal(Integer length, Integer scale)Produces a random decimal with a caller-specified whole-number digit count and fractional precision.
global static String randomDescription()Produces a random alphabetic string exactly 40 characters long, suitable for description fields.
global static String randomEmail()Produces a random, realistic-looking email address by combining name components with a randomly selected provider domain.
global static Id randomId(SObjectType sObjectType)Constructs a mock 18-character Salesforce ID based on the key prefix of the supplied SObjectType, useful for unit tests that need fake record IDs.
global static Integer randomInteger()Produces a random integer with a standard length of 6 digits.
global static Integer randomInteger(Integer upperBound)Produces a random non-negative integer up to the specified ceiling.
global static Integer randomIntegerOfLength(Integer requiredLength)Produces a random integer with exactly the specified number of digits.
global static String randomName()Produces a random alphabetic string with a standard length of 10 characters.
global static String randomNumber()Produces a random numeric string with a standard length of 6 digits.
global static String randomNumeric(Integer length)Builds a random string of the requested length using only decimal digit characters (0-9).
global static String randomPhoneNumber()Produces a random international phone number in the format '+[countryCode] ([areaCode]) [part1]-[part2]'.
global static String randomUUID()Produces a universally unique identifier in the standard 8-4-4-4-12 hexadecimal format.

nextBoolean ​

apex
global static Boolean nextBoolean()

Produces a random boolean by mapping a binary integer result to true or false.

Returns Boolean — A randomly selected boolean value.

Example

apex
Boolean randomBool = UTIL_Random.nextBoolean();
System.debug(randomBool); // Outputs: true or false

nextInteger ​

apex
global static Integer nextInteger(Integer upperBound)

Produces a random integer from zero up to the given ceiling.

Parameters

ParameterTypeDescription
upperBoundIntegerThe maximum value (inclusive).

Returns Integer — An integer between 0 and the absolute value of upperBound.

Example

apex
Integer randomInt = UTIL_Random.nextInteger(100);
System.debug(randomInt); // Outputs: e.g., 42
apex
global static Integer nextInteger(Integer lowerBound, Integer upperBound)

Produces a random integer between the specified floor and ceiling, both inclusive.

Parameters

ParameterTypeDescription
lowerBoundIntegerThe minimum value (inclusive).
upperBoundIntegerThe maximum value (inclusive).

Returns Integer — An integer within the specified boundaries.

Example

apex
Integer randomInt = UTIL_Random.nextInteger(10, 20);
System.debug(randomInt); // Outputs: e.g., 15

random ​

apex
global static String random(Integer length)

Builds a random string of the requested length from the printable ASCII character set (codes 32-126).

Parameters

ParameterTypeDescription
lengthIntegerHow many characters the result should contain.

Returns String — A random printable-ASCII string, or an empty string when length is non-positive.

Example

apex
String randomString = UTIL_Random.random(10);
System.debug(randomString); // Outputs: e.g., "Kj#9mP$2vQ"
apex
global static String random(Integer length, String characterSet)

Builds a random string of the requested length by sampling from the supplied character set.

Parameters

ParameterTypeDescription
lengthIntegerHow many characters the result should contain.
characterSetStringThe pool of characters to draw from.

Returns String — A random string composed of characters from the set, or an empty string when length is non-positive.

Example

apex
String randomCustom = UTIL_Random.random(5, 'ABC');
System.debug(randomCustom); // Outputs: e.g., "ABCCB"

randomAlphabetic ​

apex
global static String randomAlphabetic(Integer length)

Builds a random string of the requested length using only Latin letters (a-z, A-Z).

Parameters

ParameterTypeDescription
lengthIntegerHow many characters the result should contain.

Returns String — A random alphabetic string, or an empty string when length is non-positive.

Example

apex
String randomAlpha = UTIL_Random.randomAlphabetic(6);
System.debug(randomAlpha); // Outputs: e.g., "KjmPqR"

randomAlphanumeric ​

apex
global static String randomAlphanumeric(Integer length)

Builds a random string of the requested length using Latin letters and decimal digits (a-z, A-Z, 0-9).

Parameters

ParameterTypeDescription
lengthIntegerHow many characters the result should contain.

Returns String — A random alphanumeric string, or an empty string when length is non-positive.

Example

apex
String randomAlphanumeric = UTIL_Random.randomAlphanumeric(8);
System.debug(randomAlphanumeric); // Outputs: e.g., "Kj9mP2vQ"

randomDate ​

apex
global static Date randomDate()

Produces a random date falling between the Unix epoch (1970-01-01) and the current day.

Returns Date — A Date that is never in the future.

Example

apex
Date randomDate = UTIL_Random.randomDate();

randomDateTime ​

apex
global static Datetime randomDateTime()

Produces a random datetime falling between the Unix epoch (1970-01-01) and the current moment.

Returns Datetime — A Datetime that is never in the future.

Example

apex
Datetime randomDt = UTIL_Random.randomDateTime();

randomDecimal ​

apex
global static Decimal randomDecimal()

Produces a random decimal value with two digits after the decimal point.

Returns Decimal — A Decimal such as 45.67.

Example

apex
Decimal randomDec = UTIL_Random.randomDecimal();
apex
global static Decimal randomDecimal(Integer scale)

Produces a random decimal with a standard digit count and the caller-specified fractional precision.

Parameters

ParameterTypeDescription
scaleIntegerThe number of digits after the decimal point.

Returns Decimal — A Decimal with the requested precision.

Example

apex
Decimal randomDec = UTIL_Random.randomDecimal(2);
apex
global static Decimal randomDecimal(Integer length, Integer scale)

Produces a random decimal with a caller-specified whole-number digit count and fractional precision.

Parameters

ParameterTypeDescription
lengthIntegerThe magnitude of digits before the decimal point.
scaleIntegerThe number of digits after the decimal point.

Returns Decimal — A Decimal with the requested scale.

Example

apex
Decimal randomDec = UTIL_Random.randomDecimal(4, 2);

randomDescription ​

apex
global static String randomDescription()

Produces a random alphabetic string exactly 40 characters long, suitable for description fields.

Returns String — A 40-character alphabetic string.

Example

apex
String randomDesc = UTIL_Random.randomDescription();

randomEmail ​

apex
global static String randomEmail()

Produces a random, realistic-looking email address by combining name components with a randomly selected provider domain.

Returns String — A randomly composed email address such as 'john.doe@gmail.com'.

Example

apex
String randomEmail = UTIL_Random.randomEmail();

randomId ​

apex
global static Id randomId(SObjectType sObjectType)

Constructs a mock 18-character Salesforce ID based on the key prefix of the supplied SObjectType, useful for unit tests that need fake record IDs.

Parameters

ParameterTypeDescription
sObjectTypeSObjectTypeThe SObject type whose key prefix seeds the mock ID.

Returns Id — A synthetic 18-character Salesforce ID.

Throws

ExceptionDescription
IllegalArgumentExceptionWhen the SObjectType does not yield a valid 3-character key prefix.

Example

apex
Id mockId = UTIL_Random.randomId(Account.SObjectType);
System.debug(mockId); // Outputs: e.g., "00100000000lACzAAM"

randomInteger ​

apex
global static Integer randomInteger()

Produces a random integer with a standard length of 6 digits.

Returns Integer — A 6-digit random integer such as 789234.

Example

apex
Integer randomInt = UTIL_Random.randomInteger();
apex
global static Integer randomInteger(Integer upperBound)

Produces a random non-negative integer up to the specified ceiling.

Parameters

ParameterTypeDescription
upperBoundIntegerThe inclusive maximum for the generated value.

Returns Integer — A random integer between 0 and upperBound, or null when upperBound is null.

Example

apex
Integer randomInt = UTIL_Random.randomInteger(100);
System.debug(randomInt); // Outputs: e.g., 42

randomIntegerOfLength ​

apex
global static Integer randomIntegerOfLength(Integer requiredLength)

Produces a random integer with exactly the specified number of digits.

Parameters

ParameterTypeDescription
requiredLengthIntegerThe exact digit count for the generated integer.

Returns Integer — An integer guaranteed to have the requested number of digits.

Example

apex
Integer randomInt = UTIL_Random.randomIntegerOfLength(5);

randomName ​

apex
global static String randomName()

Produces a random alphabetic string with a standard length of 10 characters.

Returns String — A 10-character alphabetic string.

Example

apex
String randomName = UTIL_Random.randomName();

randomNumber ​

apex
global static String randomNumber()

Produces a random numeric string with a standard length of 6 digits.

Returns String — A 6-character numeric string.

Example

apex
String randomNum = UTIL_Random.randomNumber();

randomNumeric ​

apex
global static String randomNumeric(Integer length)

Builds a random string of the requested length using only decimal digit characters (0-9).

Parameters

ParameterTypeDescription
lengthIntegerHow many characters the result should contain.

Returns String — A random numeric string, or an empty string when length is non-positive.

Example

apex
String randomNum = UTIL_Random.randomNumeric(5);
System.debug(randomNum); // Outputs: e.g., "39281"

randomPhoneNumber ​

apex
global static String randomPhoneNumber()

Produces a random international phone number in the format '+[countryCode] ([areaCode]) [part1]-[part2]'.

Returns String — A formatted phone number such as '+123 (456) 789-0123'.

Example

apex
String randomPhone = UTIL_Random.randomPhoneNumber();

randomUUID ​

apex
global static String randomUUID()

Produces a universally unique identifier in the standard 8-4-4-4-12 hexadecimal format.

Returns String — A freshly generated UUID string.

Example

apex
String uuid = UTIL_Random.randomUUID();
System.debug(uuid); // Outputs: e.g., "550e8400-e29b-41d4-a716-446655440000"