JS & DOM Reference
OverviewJavaScript Objects
JS Array JS Boolean JS Date JS Math JS Number JS String JS RegExp JS GlobalBrowser Objects
Window Navigator Screen History LocationCore DOM Objects
DOM Node DOM NodeList DOM NamedNodeMap DOM Document DOM Element DOM AttrHTML DOM Objects
DOM Document DOM Events DOM ElementsDOM Anchor DOM Area DOM Base DOM Body DOM Button DOM Form DOM Frame/IFrame DOM Frameset DOM Image DOM Input Button DOM Input Checkbox DOM Input File DOM Input Hidden DOM Input Password DOM Input Radio DOM Input Reset DOM Input Submit DOM Input Text DOM Link DOM Meta DOM Object DOM Option DOM Select DOM Style DOM Table DOM td / th DOM tr DOM Textarea
JavaScript match() Method
Example
Search a string for "ain":
var str="The rain in SPAIN stays mainly in the plain";
var n=str.match(/ain/g);
var n=str.match(/ain/g);
The result of n 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
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 n=str.match(/ain/gi);
var n=str.match(/ain/gi);
The result of n will be:
Try it yourself »
JavaScript String Object
Your suggestion:
Close [X]
Thank You For Helping Us!
Your message has been sent to W3Schools.
Close [X]
