Symbol.match
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since январь 2020 г..
Symbol.match — известный символ, определяющий соответствие строки регулярному выражению. Этот метод вызывается функцией String.prototype.match().
Атрибуты свойства Symbol.match | |
|---|---|
| Записываемое | нет |
| Перечисляемое | нет |
| Настраиваемое | нет |
Описание
Данный метод также используется для того, чтобы определить, обладает ли объект поведением регулярного выражения. Например, методы String.prototype.startsWith(), String.prototype.endsWith() и String.prototype.includes() проверяют, является ли первый аргумент регулярным выражением, и бросают TypeError, если это так. Соответственно, если символ match установлен в false (или имеет ложное значение) — это говорит о том, что объект не предназначен для использования в качестве регулярного выражения.
Примеры
Блокировка проверки isRegExp
Следующий код выбросит TypeError:
"/bar/".startsWith(/bar/); // Бросает TypeError, так как /bar/ является
// регулярным выражением и Symbol.match не изменён.
Несмотря на это, если вы зададите свойству Symbol.match значение false, проверка isRegExp (которая использует свойство match) покажет, что объект не является регулярным выражением — как следствие, методы startsWith и endsWith не станут бросать TypeError.
var re = /foo/;
re[Symbol.match] = false;
"/foo/".startsWith(re); // true
"/baz/".endsWith(re); // false
Спецификации
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-symbol.match |
Совместимость с браузерами
Loading…