Package Exports

@jsbits/escape-regex-str

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@jsbits/escape-regex-str) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@jsbits/escape-regex-str

Part of the JSBits suite.

Escapes special characters in a string, for matching substrings with a RegExp instance.

Install

npm i @jsbits/escape-regex-str
# or
yarn add @jsbits/escape-regex-str

Targets

ES5 compatible browser
NodeJS v4.2 or later

`escapeRegexStr(str)` ⇒ `string`

Escapes special characters in a given string in preparation to be used as argument of the JS RegExp constructor, useful when you want to match the given string as a literal substring.

Param	Type	Description
str	`string`	A string.

Returns: string - The escaped string.

Since 1.0.0
Group: dev
Author/Maintainer: @aMarCruz

Example

import escapeRegexStr from '@jsbits/escape-regex-str'

const sourceStr = 'Unicorn (white): $'

// without escapeRegexStr, the test fails.
const regex1 = new RegExp(sourceStr)
console.log(regex1.test('Unicorn (white): $1.00')) // ⇒ false

// with escapeRegexStr, it succeeds.
const regex2 = new RegExp(escapeRegexStr(sourceStr))
console.log(regex2.test('Unicorn (white): $1.00')) // ⇒ true

Imports

All the JSBits functions works in strict mode and are compatible with:

ES5 browsers, through the jQuery $.jsbits object or the global jsbits.
ESM Bundlers, like webpack and Rollup.
ES modules for modern browsers or NodeJS with the --experimental-modules flag.
CommonJS modules of NodeJS, jspm, and others.
Babel and TypeScript, through ES Module Interop.

Please see the Distribution Formats in the JSBits README to know about all the variants.