regex-repo

A a collection of useful regular expressions. Refer to the regex reference below for a list of the provided REs.

Installation

npm i @liquid-labs/regex-repo

Supports both CJS and ESM packages.

Usage

import { emailRe } from '@liquid-labs/regex-repo' // ES6
// const { emailRe } = require('@liquid-labs/regex-repo') // cjs

const verified = emailRe.test(userInput)

Regex reference

Each regular expression listed below is paired with an embeddable string named xxxString. E.g., rgbRe is paired with rgbReString. Each Re will only match strings that are the given type and nothing else. I.e., the RE begins with '^' and ends with '$'. The xxxReString can be used for partial matches, matchAlls, and used as part of larger expressions. E.g., to find all unique CSS RGB colors used in a style sheet, you might do something like:

import { rgbReString } from '@liquid-labs/regex-repo'

const allColors = cssContent
  .matchAll(new RegExp(`[ :](${rgbReString})[; }]`, 'g'))
  .map((match) => match[1]) // extract the capture group
  .filter((v, i, arr) => i === arr.indexOf(v)) // filter non-unique items
  .sort()

API generated with dmd-readme-api.

Constants:
- AWS
  - awsS3BucketNameRe: Matches (most) valid S3 bucket name.
  - awsS3TaBucketNameRe: Matches (most) S3 Transfer Acceleration compatible S3 bucket name.
- Contacts
  - emailRe: Match most valid emails.
  - usPhoneRe: Matches US phone numbers with optional country code and area code.
  - zipCodeRe: Matches 5 or 9 digit US zip codes.
- CSS
  - cssColor3Re: Matches CSS3 'hex, rgb, rgba, hsl, and predefined colors.
  - cssColorRe: Matches CSS4 'hex, rgb, rgba, hsl, and predefined colors.
  - cssPreColors1Re: Matches CSS1 predefined color names.
  - cssPreColors2Re: Matches CSS2 predefined color names.
  - cssPreColors3Re: Matches CSS3 predefined color names.
  - cssPreColorsRe: Matches CSS4 predefined color names.
  - hexColorAlphaRe: Matches hex specified RGBA colors with an alpha channel.
  - hexColorNoAlphaRe: Matches hex specified RGB colors with no alpha channel.
  - hsl3Re: Matches CSS3 'hsl(...) and hsla(...) deg and percent notation.
  - hslRe: Matches CSS4 'hsl(...) and hsla(...) deg, grad, rad, turn and percent notation.
  - rgbaFuncRe: Matches CSS3 'rgba(...) using '0...255 and percent (integer) notation.
  - rgbFuncRe: Matches CSS1 'rgb(...) using '0...255 and percent (integer) notation.
  - rgbRe: Matches CSS4 'rgb(...) and rgba(...) functios using '0...255 and percent (float) notation.
- CSS numbers
  - zeroTo100FloatPercentRe: Matches a 0 to 100% float as used in CSS color specifications.
  - zeroTo100PercentRe: Matches a 0 to 100% integer as used in CSS color specifications.
  - zeroTo1FloatRe: Matches a 0 to 1 float as used in CSS color specifications.
  - zeroTo255FloatRe: Matches a 0 to 255 float as used in CSS color specifications.
  - zeroTo255Re: Matches a 0 to 255 integer as used in CSS color specifications.
  - zeroTo360FloatRe: Matches a 0 to 360 float as used in CSS color specifications.
  - zeroTo360Re: Matches a 0 to 360 integer as used in CSS color specifications.
- Date time
  - intlDateRe: Matches an international style 'YYYY/MM/DD' string.
  - iso8601DateRe: Matches an ISO 8601 date time like '20240101T1212Z.
  - iso8601DateReString: Matches the time designation portion of an ISO 8601 date+time.
  - iso8601DateTimeRe: Matches an ISO 8601 requiring both date and time components.
  - iso8601DayReString: An RE ready string that matches the day designation portion of an ISO 8601 date+time.
  - militaryTimeRe: Matches military time style 'HHMM' string.
  - rfc2822DateRe: Matches an RFC 2822 style date like 'Mon, 6 Jan 1992 12:12 UTC'.
  - rfc2822DayReString: An RE ready string that matches the day designation portion of an RFC 2822 date+time.
  - rfc2822TimeReString: An RE ready string that matches the time designation portion of an RFC 2822 date+time.
  - timeRe: Matches a twelve hour time designation, requires AM or PM designation.
  - timezoneReString: An RE ready string that matches a general timezone designation; compliant with RFC 2822 timezone portion.
  - twentyFourHourTimeRe: Matches a twenty-four hour time designationAllows optional leading 0 in hour.
  - usDateRe: Matches a US style 'MM/DD/YYYY' string.
- Domain names
  - domainLabelRe: Matches a non-tld domain label.
  - fqDomainNameRe: Matches fully qualified domain name (one or more subdomains + TLD).
  - localhostRe: Matches any representation of localhost; the special name, IPV4 loopbacks, or IPV6 loopbacks.
  - tldNameRe: Matches a Top Level Domain (TLD).
- Identifiers
  - einRe: Matches a valid EIN number.
  - ssnRe: Matches a valid SSN.
  - uuidRe: Matches a UUID.
- Javascript
  - jsReservedWordRe: Matches a JS resereved word.
  - jsVariableRe: Matches a valid JS variable name.
- Network
  - ipAddressRe: Matches a string in IP address format.
  - ipHostRe: Matches a valid, non-localhost IP address.
  - ipV6Re: Matches a string in IPV6 format.
  - ipVFutureRe: Matches potential future IP protocols.
- NPM
  - npmPackageNameRe: Matches an NPM package name.
- Numbers
  - floatRe: Matches a float in either plan or scientific format.
  - integerRe: Matches an integer.
  - plainFloatRe: Matches a plain (non-scientific notation) float.
  - scientificFloatRe: Matches a scientific notation float.
- URL
  - commonUrlRe: Matches any of the "common" web URL types: 'mailto', 'http/https', 'ftp', and 'file'.
  - fileUrlRe: Matches a valid 'file' URL.
  - ftpUrlRe: Matches a valid 'ftp' URL.
  - httpUrlRe: Matches a valid 'http/https' URL.
  - mailtoUrlRe: Matches a valid 'mailto:' URL.
  - urlRe: Matches a valid, generic URL.

`awsS3BucketNameRe` ^{↱^{source code}} ^{⇧^{AWS index | global index}}

Matches (most) valid S3 bucket name. Note awsS3BucketNameReString cannot be used for partial matches. Does not enforce 63 character limit.

`awsS3TaBucketNameRe` ^{↱^{source code}} ^{⇧^{AWS index | global index}}

Matches (most) S3 Transfer Acceleration compatible S3 bucket name. Note awsS3TaBucketNameReString cannot be used for partial matches.

`emailRe` ^{↱^{source code}} ^{⇧^{Contacts index | global index}}

Match most valid emails. Provides matching groups 1 (user name) and 2 (domain). When using the partial string to create a Re, you must use the 'u' flag.

`usPhoneRe` ^{↱^{source code}} ^{⇧^{Contacts index | global index}}

Matches US phone numbers with optional country code and area code.

`zipCodeRe` ^{↱^{source code}} ^{⇧^{Contacts index | global index}}

Matches 5 or 9 digit US zip codes.

`cssColor3Re` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches CSS3 'hex, rgb, rgba, hsl, and predefined colors.

`cssColorRe` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches CSS4 'hex, rgb, rgba, hsl, and predefined colors.

`cssPreColors1Re` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches CSS1 predefined color names.

`cssPreColors2Re` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches CSS2 predefined color names.

`cssPreColors3Re` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches CSS3 predefined color names.

`cssPreColorsRe` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches CSS4 predefined color names.

`hexColorAlphaRe` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches hex specified RGBA colors with an alpha channel.

`hexColorNoAlphaRe` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches hex specified RGB colors with no alpha channel.

`hsl3Re` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches CSS3 'hsl(...) and hsla(...) deg and percent notation.

`hslRe` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches CSS4 'hsl(...) and hsla(...) deg, grad, rad, turn and percent notation.

`rgbaFuncRe` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches CSS3 'rgba(...) using '0...255 and percent (integer) notation.

`rgbFuncRe` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches CSS1 'rgb(...) using '0...255 and percent (integer) notation.

`rgbRe` ^{↱^{source code}} ^{⇧^{CSS index | global index}}

Matches CSS4 'rgb(...) and rgba(...) functios using '0...255 and percent (float) notation.

`zeroTo100FloatPercentRe` ^{↱^{source code}} ^{⇧^{CSS numbers index | global index}}

Matches a 0 to 100% float as used in CSS color specifications.

`zeroTo100PercentRe` ^{↱^{source code}} ^{⇧^{CSS numbers index | global index}}

Matches a 0 to 100% integer as used in CSS color specifications.

`zeroTo1FloatRe` ^{↱^{source code}} ^{⇧^{CSS numbers index | global index}}

Matches a 0 to 1 float as used in CSS color specifications.

`zeroTo255FloatRe` ^{↱^{source code}} ^{⇧^{CSS numbers index | global index}}

Matches a 0 to 255 float as used in CSS color specifications.

`zeroTo255Re` ^{↱^{source code}} ^{⇧^{CSS numbers index | global index}}

Matches a 0 to 255 integer as used in CSS color specifications.

`zeroTo360FloatRe` ^{↱^{source code}} ^{⇧^{CSS numbers index | global index}}

Matches a 0 to 360 float as used in CSS color specifications.

`zeroTo360Re` ^{↱^{source code}} ^{⇧^{CSS numbers index | global index}}

Matches a 0 to 360 integer as used in CSS color specifications.

`intlDateRe` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

Matches an international style 'YYYY/MM/DD' string. Accepts separators '.', '/', '-'. Will except 1 or 2 digits for month and day and 1-4 digits for the year. Also accepts a + or - before the year. Provides capture groups 1 (BCE/CE indicator), 2 (year), 3 (month), 4 (day).

`iso8601DateRe` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

Matches an ISO 8601 date time like '20240101T1212Z. Provides matching groups 1 (year), 3 (month), and 4 (day of month), 5 (week of year), 6 (day of week date), and 7 (ordinal or Julian date), 8 (special end of day time), 10 (hour), 11 (decimal fraction of hour), 13 (minute), 14 (decimal fraction of minute), 15 (seconds), 16 (decimal fraction of a second), and 17 (timezone designation). (Groups 2, 11, and 13 are internal back references.)

`iso8601DateReString` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

Matches the time designation portion of an ISO 8601 date+time. Provides matching groups 1 (special end of day time), 3 (hours), 3 (fraction of hour), 5 (minutes), 6 (fraction of minute), 7 (seconds), and 8 (fraction of seconds).

`iso8601DateTimeRe` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

Matches an ISO 8601 requiring both date and time components. See iso8601DateRe for matching groups.

`iso8601DayReString` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

An RE ready string that matches the day designation portion of an ISO 8601 date+time. Provides matching groups 1 ( year), 3 (month), and 4 (day of month), 5 (week of year), 6 (day of week date), and 7 (ordinal or Julian date).

`militaryTimeRe` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

Matches military time style 'HHMM' string. Provides capture groups 1 (special 2400 time), 2 (hour), and 3 (minutes).

`rfc2822DateRe` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

Matches an RFC 2822 style date like 'Mon, 6 Jan 1992 12:12 UTC'. Provides matching groups 1 (day of week), 2 (day of month), 3 (month name), and 4 (year), 5 (hour), 6 (min), 7 (second), and 8 (time zone).

`rfc2822DayReString` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

An RE ready string that matches the day designation portion of an RFC 2822 date+time. Provides matching groups 1 (day of week name), 2 (day of month), 3 (month name), 4 (year).

`rfc2822TimeReString` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

An RE ready string that matches the time designation portion of an RFC 2822 date+time. Provides matching groups 1 (hour), 2 (minutes), 3 (seconds), and 4 (timezone).

`timeRe` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

Matches a twelve hour time designation, requires AM or PM designation. Allows optional leading 0 in hour. Provides matching groups 1 (hour), 2 (minutes), 3 (seconds, without decimal fractions), 4 (decimal fraction seconds), and 5 ( AM/PM indicator).

`timezoneReString` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

An RE ready string that matches a general timezone designation; compliant with RFC 2822 timezone portion. Provides matching groups 1 (timezone).

`twentyFourHourTimeRe` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

Matches a twenty-four hour time designationAllows optional leading 0 in hour. Provides matching groups 1 (special 24:00 designation with optional seconds), 2 (hour), 3 (minutes), 4 (seconds, without decimal fractions), 5 (decimal fraction seconds).

`usDateRe` ^{↱^{source code}} ^{⇧^{Date time index | global index}}

Matches a US style 'MM/DD/YYYY' string. Accepts separators '.', '/', '-'. Will except 1 or 2 digits for month and day and 1-4 digits for the year. Also accepts a + or - before the year. Provides capture groups 1 (month), 2 (day of month), 3 (BCE/CE indicator), and 4 (year).

`domainLabelRe` ^{↱^{source code}} ^{⇧^{Domain names index | global index}}

Matches a non-tld domain label. Enforces the 63 byte domain label limit for non-international (all ASCII) labels. See domain name rules. When using the partial string to create a Re, you must use the 'u' or 'v' flag.

`fqDomainNameRe` ^{↱^{source code}} ^{⇧^{Domain names index | global index}}

Matches fully qualified domain name (one or more subdomains + TLD). Partially enforces the 255 byte FQ domain name limit, but this is only valid for non-international (all ASCII) domain names because we can only count characters. When using the partial string to create a Re, you must use the 'u' or 'v' flag.

`localhostRe` ^{↱^{source code}} ^{⇧^{Domain names index | global index}}

Matches any representation of localhost; the special name, IPV4 loopbacks, or IPV6 loopbacks.

`tldNameRe` ^{↱^{source code}} ^{⇧^{Domain names index | global index}}

Matches a Top Level Domain (TLD). See domain name rules. When using the partial string to create a Re, you must use the 'u' or 'v' flag.

`einRe` ^{↱^{source code}} ^{⇧^{Identifiers index | global index}}

Matches a valid EIN number.

`ssnRe` ^{↱^{source code}} ^{⇧^{Identifiers index | global index}}

Matches a valid SSN. Provides 3 matching groups, 1 (area number), 2 (group number), and 3 (serial number).

`uuidRe` ^{↱^{source code}} ^{⇧^{Identifiers index | global index}}

Matches a UUID.

`jsReservedWordRe` ^{↱^{source code}} ^{⇧^{Javascript index | global index}}

Matches a JS resereved word.

`jsVariableRe` ^{↱^{source code}} ^{⇧^{Javascript index | global index}}

Matches a valid JS variable name.

`ipAddressRe` ^{↱^{source code}} ^{⇧^{Network index | global index}}

Matches a string in IP address format. Use 'ipHostRe' to match actually valid IP addresses.

`ipHostRe` ^{↱^{source code}} ^{⇧^{Network index | global index}}

Matches a valid, non-localhost IP address.

`ipV6Re` ^{↱^{source code}} ^{⇧^{Network index | global index}}

Matches a string in IPV6 format.

`ipVFutureRe` ^{↱^{source code}} ^{⇧^{Network index | global index}}

Matches potential future IP protocols.

`npmPackageNameRe` ^{↱^{source code}} ^{⇧^{NPM index | global index}}

Matches an NPM package name. Provides matching groups 1 (org name, if any) and 2 (package basename).

`floatRe` ^{↱^{source code}} ^{⇧^{Numbers index | global index}}

Matches a float in either plan or scientific format.

`integerRe` ^{↱^{source code}} ^{⇧^{Numbers index | global index}}

Matches an integer.

`plainFloatRe` ^{↱^{source code}} ^{⇧^{Numbers index | global index}}

Matches a plain (non-scientific notation) float.

`scientificFloatRe` ^{↱^{source code}} ^{⇧^{Numbers index | global index}}

Matches a scientific notation float.

`commonUrlRe` ^{↱^{source code}} ^{⇧^{URL index | global index}}

Matches any of the "common" web URL types: 'mailto', 'http/https', 'ftp', and 'file'. You must use the either the 'u' or 'v' flag when using the Re string.

`fileUrlRe` ^{↱^{source code}} ^{⇧^{URL index | global index}}

Matches a valid 'file' URL. Provides capture groups 1 (host), 2 (port), 3 (path). You must use the either the 'u' or 'v' flag when using the Re string.

`ftpUrlRe` ^{↱^{source code}} ^{⇧^{URL index | global index}}

Matches a valid 'ftp' URL. Provides capture groups 1 (username), 2 (user password), 3 (host or IP), 4 (port), 5 (path). You must use the either the 'u' or 'v' flag when using the Re string.

`httpUrlRe` ^{↱^{source code}} ^{⇧^{URL index | global index}}

Matches a valid 'http/https' URL. Provides capture groups 1 (protocol), 2 (username), 3 (user password), 4 (host or IP), 5 (port), 6 (path), 7 (query string), and 8 (fragment). You must use the either the 'u' or 'v' flag when using the Re string.

`mailtoUrlRe` ^{↱^{source code}} ^{⇧^{URL index | global index}}

Matches a valid 'mailto:' URL. Provides a single capture group, 1 (email address).' You must use the either the 'u' or 'v' flag when using the Re string.

`urlRe` ^{↱^{source code}} ^{⇧^{URL index | global index}}

Matches a valid, generic URL. Provides capture groups 1 (schema), 2 (server/authority), 3 (path), 4 (query part), 5 ( intra-page link/fragment.) Note, a URL always has scheme, and at a minimum a server/authority or path, and may have both. The query and fragment components are always optional. For general usage, you might want to use the more specific Res for specific protocols or the commonUrlRe.

Domain name rules

Unfortunately, there isn't clear consensus on what is allowed in a subdomain vs a top level domain (TLD); referred to collectively as 'domain labels'. So, here are the rules we follow:

Domain labels may no more than 63 bytes in length.
Labels are composed of alpha-numeric characters (a-z, 0-9, and any non-ASCII Unicode character) and hyphens ('-'), except:
- the label may not begin or end with a hyphen,
- may not consist of a single digit,
- the label must not have consecutive hyphens in the 3rd and 4th position. E.g. 'xy--z' is invalid.¹
TLDs must be at least two bytes (two ASCII characters or a single Unicode character) and may not be composed only of digits.
A fully qualified domain is limited to 255 bytes in total.

The DNS protocol only allows a-z, 0-9, and '-' in domain labels. International domains are encoded as special 'xn--' domains. E.g., 'कॉम"' is encoded as 'xn--11b4c3d'. This is why hyphens in the third and fourth position are restricted. So, while 'xn--11b4c3d' is a valid domain, you can't register such domains directly. You would register the international domain and it's translated to an 'xn--' domain in the background. ↩

Name		Name	Last commit message	Last commit date
Latest commit History 475 Commits
.github/workflows		.github/workflows
.readme-assets		.readme-assets
make		make
src		src
.gitignore		.gitignore
.jsdoc2md.json		.jsdoc2md.json
LICENSE.txt		LICENSE.txt
Makefile		Makefile
README.md		README.md
jsdoc.config.json		jsdoc.config.json
package-lock.json		package-lock.json
package.json		package.json

License

liquid-labs/regex-repo

Folders and files

Latest commit

History

Repository files navigation

regex-repo

Installation

Usage

Regex reference

awsS3BucketNameRe ↱source code ⇧AWS index | global index

awsS3TaBucketNameRe ↱source code ⇧AWS index | global index

emailRe ↱source code ⇧Contacts index | global index

usPhoneRe ↱source code ⇧Contacts index | global index

zipCodeRe ↱source code ⇧Contacts index | global index

cssColor3Re ↱source code ⇧CSS index | global index

cssColorRe ↱source code ⇧CSS index | global index

cssPreColors1Re ↱source code ⇧CSS index | global index

cssPreColors2Re ↱source code ⇧CSS index | global index

cssPreColors3Re ↱source code ⇧CSS index | global index

cssPreColorsRe ↱source code ⇧CSS index | global index

hexColorAlphaRe ↱source code ⇧CSS index | global index

hexColorNoAlphaRe ↱source code ⇧CSS index | global index

hsl3Re ↱source code ⇧CSS index | global index

hslRe ↱source code ⇧CSS index | global index

rgbaFuncRe ↱source code ⇧CSS index | global index

rgbFuncRe ↱source code ⇧CSS index | global index

rgbRe ↱source code ⇧CSS index | global index

zeroTo100FloatPercentRe ↱source code ⇧CSS numbers index | global index

zeroTo100PercentRe ↱source code ⇧CSS numbers index | global index

zeroTo1FloatRe ↱source code ⇧CSS numbers index | global index

zeroTo255FloatRe ↱source code ⇧CSS numbers index | global index

zeroTo255Re ↱source code ⇧CSS numbers index | global index

zeroTo360FloatRe ↱source code ⇧CSS numbers index | global index

zeroTo360Re ↱source code ⇧CSS numbers index | global index

intlDateRe ↱source code ⇧Date time index | global index

iso8601DateRe ↱source code ⇧Date time index | global index

iso8601DateReString ↱source code ⇧Date time index | global index

iso8601DateTimeRe ↱source code ⇧Date time index | global index

iso8601DayReString ↱source code ⇧Date time index | global index

militaryTimeRe ↱source code ⇧Date time index | global index

rfc2822DateRe ↱source code ⇧Date time index | global index

rfc2822DayReString ↱source code ⇧Date time index | global index

rfc2822TimeReString ↱source code ⇧Date time index | global index

timeRe ↱source code ⇧Date time index | global index

timezoneReString ↱source code ⇧Date time index | global index

twentyFourHourTimeRe ↱source code ⇧Date time index | global index

usDateRe ↱source code ⇧Date time index | global index

domainLabelRe ↱source code ⇧Domain names index | global index

fqDomainNameRe ↱source code ⇧Domain names index | global index

localhostRe ↱source code ⇧Domain names index | global index

tldNameRe ↱source code ⇧Domain names index | global index

einRe ↱source code ⇧Identifiers index | global index

ssnRe ↱source code ⇧Identifiers index | global index

uuidRe ↱source code ⇧Identifiers index | global index

jsReservedWordRe ↱source code ⇧Javascript index | global index

jsVariableRe ↱source code ⇧Javascript index | global index

ipAddressRe ↱source code ⇧Network index | global index

ipHostRe ↱source code ⇧Network index | global index

ipV6Re ↱source code ⇧Network index | global index

ipVFutureRe ↱source code ⇧Network index | global index

npmPackageNameRe ↱source code ⇧NPM index | global index

floatRe ↱source code ⇧Numbers index | global index

integerRe ↱source code ⇧Numbers index | global index

plainFloatRe ↱source code ⇧Numbers index | global index

scientificFloatRe ↱source code ⇧Numbers index | global index

commonUrlRe ↱source code ⇧URL index | global index

fileUrlRe ↱source code ⇧URL index | global index

ftpUrlRe ↱source code ⇧URL index | global index

httpUrlRe ↱source code ⇧URL index | global index

mailtoUrlRe ↱source code ⇧URL index | global index

urlRe ↱source code ⇧URL index | global index