JavaScript String match() metod

Definition och användning

match() Metoden matchar strängen med det reguljära uttrycket.

Tips:Om sökvärdet är en sträng, konverteras det till ett reguljärt uttryck.

match() Metoden returnerar en array som innehåller matchande poster.

Om ingen match hittas, returneras match() Metoden returnerar null。

Se också:

Reguljärt uttryck tutorial

Reguljärt uttryck referenshandbok

Skillnaden mellan String match() och String search()

match() Metoden returnerar matchningsarrayen.

search() Metoden returnerar den första matchens position.

Exempel

Exempel 1

Sök "ain" med sträng:

let text = "The rain in SPAIN stays mainly in the plain";
text.match("ain");

Prova själv

Exempel 2

Sök "ain" med reguljärt uttryck:

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/);

Prova själv

Exempel 3

Global sökning av "ain":

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/g);

Prova själv

Exempel 4

Global, case-insensitive sökning:

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/gi);

Prova själv

Syntaks

string.match(regexp)

Parameter

Parameter 描述
regexp

Obligatorisk. Sökvärde.

Reguljärt uttryck (eller kommer att konverteras till ett reguljärt uttryck som sträng).

Returvärde

Typ 描述
Array eller null

Array som innehåller matchande poster.

Om ingen match hittas, returneras null。

Tekniska detaljer

Parameter regexp

Denna parameter specificerar det reguljära uttryck som RegExp-objekt att matcha. Om denna parameter inte är ett RegExp-objekt, kommer den först att passeras till RegExp() konstruktorn och konverteras till ett RegExp-objekt.

Returvärde

Array som lagrar matchningsresultaten. Innehållet i denna array beror på regexp 是否具有全局标志 g。下面详细说明了这个返回值。

说明

match() 方法将检索字符串 string，以找到一个或多个与 regexp 匹配的文本。这个方法的行为在很大程度上有赖于 regexp 是否具有标志 g。

如果 regexp 没有标志 g，那么 match() 方法就只能在 string 中执行一次匹配。如果没有找到任何匹配的文本，match() 将返回 null。否则，它将返回一个数组，其中存放了与它找到的匹配文本有关的信息。该数组的第 0 个元素存放的是匹配文本，而其余的元素存放的是与正则表达式的子表达式匹配的文本。除了这些常规的数组元素之外，返回的数组还含有两个对象属性。index 属性声明的是匹配文本的起始字符在 string 中的位置，input 属性声明的是对 string 的引用。

如果 regexp 具有标志 g，则 match() 方法将执行全局检索，找到 string 中的所有匹配子字符串。若没有找到任何匹配的子串，则返回 null。如果找到了一个或多个匹配子串，则返回一个数组。不过全局匹配返回的数组的内容与前者大不相同，它的数组元素中存放的是 string 中所有的匹配子串，而且也没有 index 属性或 input 属性。

注意：在全局检索模式下，match() 即不提供与子表达式匹配的文本的信息，也不声明每个匹配子串的位置。如果您需要这些全局检索的信息，可以使用 RegExp.exec()。

正则表达式搜索方法

在JavaScript中，正则表达式文本搜索可以用不同的方法完成。

通过将模式作为正则表达式，这些是最常用的方法：

示例 描述
text.match(pattern) 字符串方法 match()
text.search(pattern) 字符串方法 search()
pattern.exec(text) 正则表达式方法 exec()
pattern.test(text) 正则表达式方法 test()

浏览器支持

match() 是 ECMAScript1 (ES1) 特性。

所有浏览器都完全支持 ES1 (JavaScript 1997)：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 支持 支持 支持 支持 支持

相关页面

JavaScript sträng

JavaScript strängmetoder

JavaScript strängsökning