Regex Utils

This library contains utilities that are useful when working with JavaScript regular expressions.

The functions are not exported as default, so you can import them in one of the following ways:

// ES6
import { functionName } from '@ptolemy2002/regex-utils';
// CommonJS
const { functionName } = require('@ptolemy2002/regex-utils');

Functions

The following functions are available in the library:

combineFlags

Description

Combines two sets of flags into one string. If a flag is present in both sets, it will only appear once in the result.

Parameters

• ...flags (String[]): The sets of flags to be combined. Falsey values will be ignored.

Returns

String - The combined flags.

escapeRegex

Description

Escapes a string so that it can be used as a literal in a regular expression. If spefifying a RegExp object, the flags are added after transforming the source to a literal.

Parameters

• value (String | RegExp): The value to be escaped.
• flags (String): The flags to be used in the regular expression. If a RegExp object is passed, these flags will be added to the existing flags.

Returns

RegExp - The escaped regular expression.

regexAccentInsensitive

Description

Attempts to transform a RegExp object to be accent insensitive. Note that this is done using a static list of common characters and their accented versions, so it is not perfect.

Parameters

• value (String | RegExp): The value to be transformed to be accent insensitive.
• flags (String): The flags to be used in the regular expression. If a RegExp object is passed, these flags will be added to the existing flags.

Returns

RegExp - The accent insensitive regular expression.

removeAccents

Description

Attempts to remove accents from a string. Note that this is done using a static list of common characters and their accented versions, so it is not perfect.

Parameters

• value (String): The value to be transformed to remove accents.

Returns

String - The string with accents removed.

regexCaseInsensitive

Description

Transforms a RegExp object to be case insensitive by adding the i flag.

Parameters

• value (String | RegExp): The value to be transformed to be case insensitive.
• flags (String): The flags to be used in the regular expression. If a RegExp object is passed, these flags will be added to the existing flags.

Returns

RegExp - The case insensitive regular expression.

regexMatchWhole

Description

Transforms a RegExp object to match the whole string by adding ^ and $ to the beginning and end of the source, respectively.

Parameters

• value (String | RegExp): The value to be transformed to match the whole string.
• flags (String): The flags to be used in the regular expression. If a RegExp object is passed, these flags will be added to the existing flags.

transformRegex

Description

This function is a quick way to apply multiple supported transformations to a regular expression.

Parameters

• value (String | RegExp): The value to be transformed.
• args (Object): Used to specify optional arguments.
  • accentInsensitive (Boolean): Whether to make the regular expression accent insensitive. Default is false.
  • caseInsensitive (Boolean): Whether to make the regular expression case insensitive. Default is false.
  • matchWhole (Boolean): Whether to make the regular expression match the whole string. Default is false.
  • flags (String): The flags to be used in the regular expression. If a RegExp object is passed, these flags will be added to the existing flags.

Returns

RegExp - The transformed regular expression.

isValidRegex

Description

Checks if a string is a valid regular expression by attempting to create a RegExp object with it.

Parameters

• value (String): The value to be checked.
• flags (String): The flags to be used in the regular expression.

Returns

Boolean - true if the string is a valid regular expression, false otherwise.

isValidRegexFlags

Description

Checks if a string is a valid set of regular expression flags.

Parameters

• value (String): The value to be checked.

Returns

Boolean - true if the string is a valid set of regular expression flags, false otherwise.

zodValidate

Description

This is a simple function that takes a zod schema, returning a function that takes a value. If the value matches, the function returns true. Otherwise, it returns whatever error message the zod schema provides by default, or false if the returnError flag is disabled.

Parameters

• p (ZodSchema): The zod schema to be used for validation.
• returnError (Boolean): Whether to return the error message if the value does not match the schema. Default is true. If false, the function will return false on failure instead.

Returns

Function - A function that takes a value and returns true if the value matches the schema, an error message if the value does not match the schema and returnError is true, or false if the value does not match the schema and returnError is false.

Returns

Function - A function that takes a value and returns true if the value matches the schema, or an error message otherwise.

isAlphanumeric

Description

Uses zodValidate to check if a string is alphanumeric, that is, if it only contains letters, numbers, dashes, and underscores. Empty strings are not considered alphanumeric.

Parameters

• str (String): The value to be checked.

Returns

Boolean - true if the string is alphanumeric, false otherwise.

toAlphanumeric

Description

Transforms a string to be alphanumeric by removing accents, separating it by non-alphanumeric segments, and then joining the words with the specified separator.

Parameters

• str (String): The value to be transformed.
• separator (String): The separator to be used between words. Default is '-'.

Returns

String - The transformed string.

isValidEmail

Description

Uses zodValidate to check if a string is a valid email address. Note that this is a simple check and may not cover all cases, but it should be good enough for most purposes.

Parameters

• value (String): The value to be checked.

Returns

Boolean - true if the string is a valid email address, false otherwise.

isValidPhoneNumber

Description

Uses zodValidate to check if a string is a valid phone number. Note that this is a simple check and may not cover all cases, but it should be good enough for most purposes.

Parameters

• value (String): The value to be checked.

Returns

Boolean - true if the string is a valid phone number, false otherwise.

isValidURL

Description

Uses zodValidate to check if a string is a valid URL. Note that this is a simple check and may not cover all cases, but it should be good enough for most purposes.

Parameters

• value (String): The value to be checked.

Returns

Boolean - true if the string is a valid URL, false otherwise.

isValidSSN

Description

Uses zodValidate to check if a string is a valid Social Security Number (SSN). Note that this is a simple check and may not cover all cases, but it should be good enough for most purposes.

Parameters

• value (String): The value to be checked.

Returns

Boolean - true if the string is a valid SSN, false otherwise.

Meta

This is a React Library Created by Ptolemy2002's cra-template-react-library template in combination with create-react-app. However, it does not actually depend on React - it has been modified to work out of the box. It contains methods of building and publishing your library to npm.

Peer Dependencies

This project does not have any peer dependencies, so it should work out of the box.

Commands

The following commands exist in the project:

• npm run uninstall - Uninstalls all dependencies for the library
• npm run reinstall - Uninstalls and then Reinstalls all dependencies for the library
• npm run example-uninstall - Uninstalls all dependencies for the example app
• npm run example-install - Installs all dependencies for the example app
• npm run example-reinstall - Uninstalls and then Reinstalls all dependencies for the example app
• npm run example-start - Starts the example app after building the library
• npm run build - Builds the library
• npm run release - Publishes the library to npm without changing the version
• npm run release-patch - Publishes the library to npm with a patch version bump
• npm run release-minor - Publishes the library to npm with a minor version bump
• npm run release-major - Publishes the library to npm with a major version bump