RegExp.escape
Экранирует строку, чтобы безопасно вставить её в регулярное выражение.
Доступно с: ES2025
Синтаксис
RegExp.escape(str)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| str | string | Текст, который нужно искать буквально. |
Возвращаемое значение
stringСтрока, в которой экранированы все специальные символы.
Примеры
Точки и скобки перестают быть специальными:
const query = 'a.b (c)';
const regex = new RegExp(RegExp.escape(query), 'g');
console.log('x a.b (c) y aXb c'.replace(regex, '[found]'));Результат:
x [found] y aXb cПримечания
Без экранирования точка в тексте пользователя совпала бы с любым символом, а незакрытая скобка вызвала бы SyntaxError. Метод появился недавно; в старых браузерах используют str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&').
См. также
- RegExp — Регулярное выражение — шаблон для поиска и замены текста.
- String.prototype.replaceAll — Заменяет все вхождения подстроки на другую строку.
В учебнике
- Регулярные выражения — Регулярные выражения в JavaScript для начинающих: шаблоны, флаги, классы символов, проверка, поиск и замена текста.