HOME HTML CSS JAVASCRIPT SQL PHP JQUERY XML ASP.NET MORE...
REFERENCES | EXAMPLES | FORUM | ABOUT

JavaScript String match() Method

String Object Reference JavaScript String Object

Example

Search a string for "ain":

var str = "The rain in SPAIN stays mainly in the plain";
var res = str.match(/ain/g);

The result of res will be an array with the values:


Try it yourself »

Definition and Usage

The match() method searches a string for a match against a regular expression, and returns the matches, as an Array object.

Read more about regular expressions in our RegExp Tutorial and our RegExp Object Reference.

Note: If the regular expression does not include the g modifier (to perform a global search), the match() method will return only the first match in the string.

This method returns null if no match is found.


Browser Support

Internet Explorer Firefox Opera Google Chrome Safari

The match() method is supported in all major browsers.


Syntax

string.match(regexp)

Parameter Values

Parameter Description
regexp Required. The value to search for, as a regular expression.

Return Value

Type Description
Array An array containing the matches, one item for each match, or null if no match is found

Technical Details

JavaScript Version: 1.2


More Examples

Example

Perform a global, case-insensitive search for "ain":

var str = "The rain in SPAIN stays mainly in the plain";
var res = str.match(/ain/gi);

The result of res will be:


Try it yourself »


String Object Reference JavaScript String Object

Your suggestion:

Close [X]

Thank You For Helping Us!

Your message has been sent to W3Schools.

Close [X]
Search w3schools.com:

WEB BUILDING

Download XML Editor FREE Website BUILDER Free HTML5 Templates

SHARE THIS PAGE