String.prototype.match()

在此页

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

match() method retrieves the result of matching a string against a regular expression .

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.

句法

str.match(regexp)

参数

regexp: 若 regexp is a non- RegExp object, it is implicitly converted to a RegExp by using new RegExp( regexp ) .; If you don't give any parameter and use the match() method directly, you will get an Array with an empty string: [""] .

返回值

Array whose contents depend on the presence or absence of the global ( g ) flag, or null if no matches are found.

若 g flag is used, all results matching the complete regular expression will be returned, but capturing groups will not.
若 g flag is not used, only the first complete match and its related capturing groups are returned. In this case, the returned item will have additional properties as described below.

Additional properties

As explained above, some results contain additional properties as described below.

groups: An object of named capturing groups whose keys are the names and values are the capturing groups or undefined if no named capturing groups were defined. See Groups and Ranges 了解更多信息。
index
input

描述

If the regular expression does not include the g flag, str.match() will return the same result as RegExp.exec() .

Other methods

If you need to know if a string matches a regular expression RegExp ，使用 RegExp.test() .
If you only want the first match found, you might want to use RegExp.exec() 代替。
If you want to obtain capture groups and the global flag is set, you need to use RegExp.exec() or String.prototype.matchAll() 代替。

范例

Using match()

In the following example, match() is used to find ' 章节 ' followed by 1 or more numeric characters followed by a decimal point and numeric character 0 or more times.

The regular expression includes the i flag so that upper/lower case differences will be ignored.

const str = 'For more information, see Chapter 3.4.5.1';
const re = /see (chapter \d+(\.\d)*)/i;
const found = str.match(re);
console.log(found);
// logs [ 'see Chapter 3.4.5.1',
//        'Chapter 3.4.5.1',
//        '.1',
//        index: 22,
//        input: 'For more information, see Chapter 3.4.5.1' ]
// 'see Chapter 3.4.5.1' is the whole match.
// 'Chapter 3.4.5.1' was captured by '(chapter \d+(\.\d)*)'.
// '.1' was the last value captured by '(\.\d)'.
// The 'index' property (22) is the zero-based index of the whole match.
// The 'input' property is the original string that was parsed.

Using global and ignore case flags with match()

The following example demonstrates the use of the global and ignore case flags with match() . All letters A through E and a through e are returned, each its own element in the array.

const str = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
const regexp = /[A-E]/gi;
const matches_array = str.match(regexp);
console.log(matches_array);
// ['A', 'B', 'C', 'D', 'E', 'a', 'b', 'c', 'd', 'e']

注意： 另请参阅 String.prototype.matchAll() and Advanced searching with flags .

Using named capturing groups

In browsers which support named capturing groups, the following code captures " fox " or " cat " into a group named " animal ":

const paragraph = 'The quick brown fox jumps over the lazy dog. It barked.';
const capturingRegex = /(?<animal>fox|cat) jumps over/;
const found = paragraph.match(capturingRegex);
console.log(found.groups); // {animal: "fox"}

Using match() with no parameter

const str = "Nothing will come of nothing.";
str.match();   // returns [""]

A non-RegExp object as the parameter

When the regexp parameter is a string or a number, it is implicitly converted to a RegExp by using new RegExp( regexp ) .

If it is a positive number with a positive sign, RegExp() will ignore the positive sign.

const str1 = "NaN means not a number. Infinity contains -Infinity and +Infinity in JavaScript.",
    str2 = "My grandfather is 65 years old and My grandmother is 63 years old.",
    str3 = "The contract was declared null and void.";
str1.match("number");   // "number" is a string. returns ["number"]
str1.match(NaN);        // the type of NaN is the number. returns ["NaN"]
str1.match(Infinity);   // the type of Infinity is the number. returns ["Infinity"]
str1.match(+Infinity);  // returns ["Infinity"]
str1.match(-Infinity);  // returns ["-Infinity"]
str2.match(65);         // returns ["65"]
str2.match(+65);        // A number with a positive sign. returns ["65"]
str3.match(null);       // returns ["null"]

规范

规范
ECMAScript (ECMA-262) The definition of 'String.prototype.match' 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
`match`	Chrome 1	Edge 12	Firefox 1	IE 4	Opera 4	Safari 1	WebView Android 1	Chrome Android 18	Firefox Android 4	Opera Android 10.1	Safari iOS 1	Samsung Internet Android 1.0	nodejs 0.1.100

在此页

句法

参数

返回值