Объект RegExp - статический объект, который и генерирует экземпляры регулярного выражения, и контролирует всё регулярное выражение в текущем окне или фрейме. Экземпляры объекта RegExp обозреваются в описании объекта regular expressions, которое следует далее.

Регулярные выражения помогают в расположении текста, который соответствует образцам символов или характеристик. Например, регулярное выражение может использоваться, чтобы очень быстро выяснить, если ли в текстовом поле число с пятью цифрами. Определение соответствующего образца требует знания определённого синтаксиса, который лежит вне области этой книги (но охвачен в Mastering Regular Expressions, Jeffrey E.F. Friedl, изданной O'Reilly). Общий синтаксис может быть найден в описании объекта regular expression

Свойства объекта RegExp cохраняют информацию о последней операции любого регулярного выражения в документе. Поэтому, думается, что каждое из этих свойств изменяется после каждой операции с регулярными выражениями. Такие операции включают не только методы экземпляра объекта regular expression (exec() и test()), но также и методы объекта String, которые могут принимать регулярные выражения как параметры (match(), replace(), и split()). Некоторых из этих свойств обращаются также к объекту regular expression, подготавливаясь к следующей операции с регулярным выражением

Все свойства имеют и многословные названия, и также как shortcut-имена, которые начинаются с $.

Создание:

Формат литерального текста или функция конструктора RegExp.

Литеральный формат используется так:

/pattern/flags

Функция конструктора используется так:

new RegExp("pattern"[, "flags"])

Параметры:

pattern - Текст регулярного выражения.

flags - Флаг, если специфицирован, может иметь следующие значения в любом сочетании:

• g: глобальная подстановка
• i: игнорировать регистр
• m: подставлять на нескольких строках

Заметьте, что параметры литерального формата не используют кавычек для обозначения строк, а параметры функции конструктора - используют кавычки. Итак, следующие выражения создают одно и то же регулярное выражение:

/ab+c/i
new RegExp("ab+c", "i")

В таблице представлен полный список и описание специальных символов, которые могут использоваться в регулярных выражениях (см. также regular expression)

Литеральная нотация предоставляет компиляцию регулярного выражения при вычислении выражения. Используйте литеральную нотацию, если регулярное выражение должно остаться константой. Например, если Вы используете литеральную нотацию для построения регулярного выражения, используемого в цикле, регулярное выражение не должно перекомпилироваться при каждой итерации.

Конструктор объекта регулярного выражения, например, new RegExp("ab+c"), предоставляет компиляцию регулярного выражения на этапе прогона/runtime. Используйте функцию, если знаете, что патэрн регулярного выражения будет изменяться, или если Вы не знаете патэрн и получаете его из другого источника, такого как ввод от пользователя.

Отдельный предопределённый объект RegExp доступен для каждого окна; то есть каждый отдельный поток выполнения JavaScript получает свой собственный объект RegExp. Поскольку каждый скрипт запускается в потоке без остановки до конца выполнения, это гарантирует, что разные скрипты не перепишут значения объекта RegExp.

Обратите внимание, что некоторые свойства объекта RegExp имеют и длинные, и короткие (Perl-подобные) имена. Оба имени всегда ссылаются на одно и то же значение. Perl это язык программирования, из которого JavaScript смоделировал свои регулярные выражения.

Специфицирует функцию, которая создаёт прототип объекта. Заметьте, что значением этого свойства является ссылка на саму функцию, а не строка, содержащая имя функции.

Все объекты наследуют свойство constructor из своих prototype

o = new Object // или o = {} в JavaScript 1.2
o.constructor == Object
a = new Array // или a = [] в JavaScript 1.2
a.constructor == Array
n = new Number(3)
n.constructor == Number

Основная строка, с которой сравнено регулярное выражение. Если основная строка передана операции регулярного выражения как параметр для метода, это значение - нуль. Короткая версия $_ (долларовый знак, символ подчеркивания).

RegExp.input = "Four score and seven years ago..."

Значением свойства lastMatch является последняя найденная подстрока исходной строки. Это свойство объекта RegExp является статическим и изменяется при каждой операции сопоставления с регулярным выражением. Короткая версия $&

var matched = RegExp.lastMatch

Значением свойства lastParen является последняя запомненная подстрока исходной строки, соответствующая подвыражению регулярного выражения, заключенному в круглые скобки. Это свойство объекта RegExp является статическим и изменяется при каждой операции сопоставления с регулярным выражением. Короткая версия $+.

var myValue = RegExp.lastParen

Значением свойства leftContext является подстрока исходной строки, предшествующая последней найденной подстроке. Это свойство объекта RegExp является статическим и изменяется при каждой операции сопоставления с регулярным выражением.

Значением свойства rightContext является подстрока исходной строки, следующая за последней найденной подстрокой. Это свойство объекта RegExp является статическим и изменяется при каждой операции сопоставления с регулярным выражением. Короткие версии - $' и $' соответственно. Отправная точка значения leftContext может изменяться с каждой операцией.

var wholeContext = RegExp.leftContext + RegExp.lastMatch + RegExp.rightContext

Если поиск простирается на несколько строк текста, свойство multiline равно true. Поиск текста, например, в элементе TEXTAREA является multiline. Короткая версия - $*.

var x = new RegExp("a+b+c", "g");
document.write(x.toString());

Введенные подкомпоненты регулярного выражения возвращают результаты. Эти результаты сохраняются индивидуально в свойствах, маркированных от 1 до 9, которым предшествует символ shortcut $. Порядок основан на позиции левой круглой скобки подкомпонента: крайний левый подсоставляющий результат помещен в $1. . Регулярное выражение может содержать любое количество выражений в круглых скобках, но в объекте RegExp запоминаются только последние девять найденных соответствий. Пример: следующий сценарий

var re = new RegExp("(\\d*)\\s*(\\d*)","ig");
var arr = re.exec("111 2222 33333");
var s = "$1 = '" + RegExp.$1 + "' ";
s += "$2 = '" + RegExp.$2 + "' ";
s += "$3 = '" + RegExp.$3 + "'";
document.write(s);

выведет на экран обозревателя текст $1 = '111' $2 = '2222' $3 = ''. Эти свойства объекта RegExp являются статическими и изменяются при каждой операции сопоставления с регулярным выражением. В методе String.replace они употребляются без имени объекта RegExp. Эти свойства могут использоваться непосредственно как параметры для методов String, которые используют регулярные выражения (см. метод String.replace()).

RegExp.$2

Если часть регулярного выражения заключена в круглые скобки, то соответствующая ей подстрока запоминается для последующего использования. Значениями свойств $01, …, $99 являются подстроки исходной строки, которые были запомнены в процессе последнего сопоставления с образцом. Регулярное выражение может содержать любое количество выражений в круглых скобках, но в этих свойствах запоминаются только последние 99 найденных соответствий. Пример: следующий сценарий

var re = new RegExp("(\\d*)\\s*(\\d*)","ig");
var arr = re.exec("111 2222 33333");
var s = "$01 = '" + RegExp.$01 + "' ";
s += "$02 = '" + RegExp.$02 + "' ";
s += "$03 = '" + RegExp.$03 + "'";
document.write(s);

выведет на экран обозревателя текст $01 = '111' $02 = '2222' $03 = ''. Эти свойства объекта RegExp являются статическими и изменяются при каждой операции сопоставления с регулярным выражением. В методе String.replace они употребляются без имени объекта RegExp.

RegExp.$27

Возвращает строку исходного кода объекта

• Для встроенного объекта RegExp, toSource возвращает следующую строку, указывающую, что исходный код недоступен:
  function Boolean() {
  [native code]
  }
• Для экземпляров RegExp, toSource возвращает строку исходного кода объекта

Возвращает строку, представляющую специфицированный объект.