How to Escape RegExp Special Characters in Javascript (or Typescript)

Jasser Mark Arioste

Jasser Mark Arioste

How to Escape RegExp Special Characters in Javascript (or Typescript)

This tutorial shows you three ways to escape special characters in query strings.

Why Do you need to escape regex special characters? #

There was an issue in my projects where the user could not find records if the plus(+) symbol was included in the query string. When searching for users/records with the plus symbol included in the email field, the database did not return any results. I used MongoDB as the database and used the $regex operator.

The problem was that the query string was not escaped and MongoDB was interpreting the plus symbol differently. This is because the plus (+) symbol is a special regex character that has to be escaped!

❌ Incorrect query: {email: {$regex: /user+test/, options: "i"}}

✅ Correct query(the plus sign is now escaped!): {email: {$regex: /user\+test/, options: "i"}}

What characters need to be escaped? #

You need to escape all special regex characters so that they will be treated as regular strings. The following is the list of special characters in regex in javascript:


More info here

Using Plain Javascript/Typescript #

 To transform a string to its escaped version, we'll create a regex of all the special characters and use javascript string.replace function. I prefer this method since we don't have to install a package.


//base query
const queryString = '';

// prepend a backslash and insert the matched character.
const escapedQuery = query.replace(REGEXP_SPECIAL_CHAR, '\\$&');

console.log(escapedQuery); // user\+test@gmail\.com

//for example if we want to use it in MongoDB:
// db.users.find({
//    email: {$regex: new RegExp(escapedQuery, "i")}
// })

Using Lodash #

If you're using lodash in your project, you'll be able to save time by using lodash's escapeRegex function. Lodash is a modern javascript utility library that is still great to use in many projects!

import escapeRegExp from "lodash/escapeRegExp"

const queryString = '';

const escapedQueryLodash = escapeRegExp(queryString);
console.log(escapedQueryLodash);  // user\+test@gmail\.com

Using escape-string-regexp package #

If you're not using lodash due to its size or don't want to bother with the first method. You can use the escape-string-regexp npm package, it has a very small size and is very good at what it does. It has a very small footprint (256b) and is also written in typescript.


yarn add escape-string-regexp

# or
npm install escape-string-regexp


import escapeRegExp from 'escape-string-regexp';

const queryString = '';
const escaped = escapeRegExp(queryString)
console.log(escaped) //user\+test@gmail\.com

Conclusion #

We were able to learn three different ways to escape special regexp characters in javascript. 

If you like this tutorial please leave a like or share! If you want to be updated on our tutorials, please subscribe to our newsletter or follow me on Twitter!

Resources #

Credits: Image by David Mark from Pixabay

Share this post!

Related Posts


This content may contain links to products, software and services. Please assume all such links are affiliate links which may result in my earning commissions and fees.
As an Amazon Associate, I earn from qualifying purchases. This means that whenever you buy a product on Amazon from a link on our site, we receive a small percentage of its price at no extra cost to you. This helps us continue to provide valuable content and reviews to you. Thank you for your support!
Donate to ReactHustle