JavaScript String match() Method

## JavaScript Reference

Overview

## JavaScript Objects

JS Array JS Boolean JS Date JS Math JS Number JS String JS RegExp JS Global

## Browser Objects

Window Navigator Screen History Location

## HTML DOM Objects

DOM Document DOM Elements DOM Attributes DOM Events

## HTML Objects

DOM 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 String match() Method

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

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 »

JavaScript String Object

## Your suggestion:

Your E-mail (optional):

Page address:

Description:

Close [X]

## Thank You For Helping Us!

Your message has been sent to W3Schools.

Close [X]
Search w3schools.com:

## WEB HOSTING

Best Web Hosting UK Reseller Hosting Wow! $5 SSD Hosting

## WEB BUILDING

Download XML Editor
FREE Website BUILDER FREE Website Creator

## WEB RESOURCES

Web Statistics Web Validation

## SHARE THIS PAGE