在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

RegExp constructor creates a regular expression object for matching text with a pattern.

For an introduction to regular expressions, read the Regular Expressions chapter 在 JavaScript 指南 .

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

句法

Literal, constructor, and factory notations are possible:

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

参数

pattern

The text of the regular expression.

As of ES5, this can also be another RegExp object or literal (for the two RegExp constructor notations only). Patterns may include special characters to match a wider range of values than would a literal string.

flags

If specified, flags is a string that contains the flags to add.

Alternatively, if an object is supplied for the pattern, the flags string will replace any of that object's flags (and lastIndex will be reset to 0 ) (as of ES2015).

若 flags is not specified and a regular expressions object is supplied, that object's flags (and lastIndex value) will be copied over.

flags may contain any combination of the following characters:

g (global match)

Find all matches rather than stopping after the first match.

i (ignore case)

若 u flag is also enabled, use Unicode case folding.

m (multiline)

Treat beginning and end characters ( ^ and $ ) as working over multiple lines. In other words, match the beginning or end of each line (delimited by \n or \r ), not only the very beginning or end of the whole input string.

s ("dotAll")

Allows . to match newlines.

u (unicode)

Treat pattern as a sequence of Unicode code points. (See also 二进制字符串 ).

y (sticky)

Matches only from the index indicated by the lastIndex property of this regular expression in the target string. Does not attempt to match from any later indexes.

范例

文字表示法和构造函数

There are two ways to create a RegExp object: a literal notation 和 构造函数 .

• The literal notation's parameters are enclosed between slashes and do not use quotation marks.
• The constructor function's parameters are not enclosed between slashes but do use quotation marks.

The following three expressions create the same regular expression:

/ab+c/i
new RegExp(/ab+c/, 'i') // literal notation
new RegExp('ab+c', 'i') // constructor
					

The literal notation results in compilation of the regular expression when the expression is evaluated. Use literal notation when the regular expression will remain constant. For example, if you use literal notation to construct a regular expression used in a loop, the regular expression won't be recompiled on each iteration.

The constructor of the regular expression object—for example, new RegExp('ab+c') —results in runtime compilation of the regular expression. Use the constructor function when you know the regular expression pattern will be changing, or you don't know the pattern and are getting it from another source, such as user input.

规范

规范
ECMAScript (ECMA-262) The definition of 'RegExp constructor' in that specification.

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
RegExp() 构造函数	Chrome 1	Edge 12	Firefox 1	IE 4	Opera 5	Safari 1	WebView Android 1	Chrome Android 18	Firefox Android 4	Opera Android 10.1	Safari iOS 1	Samsung Internet Android 1.0	nodejs Yes

图例

完整支持

完整支持

另请参阅

• 正则表达式 chapter in the JavaScript 指南
• String.prototype.match()
• String.prototype.replace()

元数据

• 最后修改： May 19, 2020

相关话题

1. 标准内置对象
2. RegExp
3. 特性
   1. RegExp.$1-$9
   2. RegExp.input ($_)
   3. RegExp.lastMatch ($&)
   4. RegExp.lastParen ($+)
   5. RegExp.leftContext ($`)
   6. RegExp.prototype.dotAll
   7. RegExp.prototype.flags
   8. RegExp.prototype.global
   9. RegExp.prototype.ignoreCase
   10. RegExp.prototype.multiline
   11. RegExp.prototype.source
   12. RegExp.prototype.sticky
   13. RegExp.prototype.unicode
   14. RegExp.rightContext ($')
   15. RegExpInstance.lastIndex
   16. get RegExp[@@species]
4. 方法
   1. RegExp.prototype.compile()
   2. RegExp.prototype.exec()
   3. RegExp.prototype.test()
   4. RegExp.prototype.toSource()
   5. RegExp.prototype.toString()
   6. RegExp.prototype[@@matchAll]()
   7. RegExp.prototype[@@match]()
   8. RegExp.prototype[@@replace]()
   9. RegExp.prototype[@@search]()
   10. RegExp.prototype[@@split]()
5. 继承：
6. Function
7. 特性
   1. Function.arguments
   2. Function.caller
   3. Function.displayName
   4. Function.length
   5. Function.name
8. 方法
   1. Function.prototype.apply()
   2. Function.prototype.bind()
   3. Function.prototype.call()
   4. Function.prototype.toSource()
   5. Function.prototype.toString()
9. Object
10. 特性
    1. Object.prototype.__proto__
    2. Object.prototype.constructor
11. 方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.valueOf()
    12. Object.setPrototypeOf()