JavaScript String match() メソッド

定義と使用法

match() このメソッドは文字列と正規表現をマッチングします。

ヒント：検索値が文字列の場合、正規表現に変換されます。

match() このメソッドはマッチング結果を含む配列を返します。

マッチング結果が見つからない場合、 match() このメソッドは null。

参照もどうぞ：

正規表現チュートリアル

正規表現リファレンスマニュアル

String match()とString search()の違い

match() このメソッドはマッチング結果の配列を返します。

search() このメソッドは最初のマッチング位置を返します。

例

例1

文字列を使用して「ain」を検索：

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

自分で試してみてください

例2

正規表現を使用して「ain」を検索：

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

自分で試してみてください

例3

「ain」のグローバル検索：

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

自分で試してみてください

例4

グローバル、大小文字を区別しない検索：

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

自分で試してみてください

文法

string.match(regexp)

パラメータ

パラメータ 説明
regexp

必須。検索値。

正規表現（または正規表現に変換される文字列）。

返り値

タイプ 説明
配列または null

マッチング結果を含む配列。

マッチング結果が見つからない場合、 null。

技術的な詳細

パラメータ regexp

このパラメータはマッチングするパターンの RegExp オブジェクトを指定します。このパラメータが RegExp オブジェクトでない場合、まずそれを RegExp() 构造関数に渡し、RegExp オブジェクトに変換します。

返り値

マッチング結果を保存する配列。この配列の内容は依存しています。 regexp グローバルフラグを持っているかどうか g。以下に詳細に説明します。

説明

match() メソッドは、 stringを検索します。 regexp 方法は、 regexp を検索して、 g。

が regexp メソッドの動作は非常に依存します。 match() にない場合、 string メソッドは、フラグ g がmatch() を1回検索します。一致テキストが見つからない場合、 nullを返します。それ以外の場合、見つけた一致テキストに関する情報を含む配列を返します。この配列の第0要素は一致テキスト、残りは正規表現の子表現に一致するテキストです。これらの一般的な配列要素に加えて、返される配列には2つのオブジェクト属性も含まれています。index 属性は、一致テキストの始端文字が string の位置を宣言しています。input 属性は、 string の参照を持つ

が regexp フラグを持つ gが見つかった場合、 match() メソッドはグローバル検索を実行し、 string すべての一致子文字列が含まれています。一致子文字列が見つからない場合、 null。一致子文字列が1つまたは複数見つかった場合、配列が返されます。ただし、グローバルマッチで返される配列の内容は前者とは異なります。配列の要素には、 string すべての一致子文字列が含まれており、index 属性や input 属性もありません。

注意：グローバル検索モードでは、match() 子表現に一致するテキストの情報を提供せず、各一致子文字列の場所を宣言しません。これらの情報が必要な場合は、 RegExp.exec()。

正規表現検索メソッド

JavaScript では、正規表現のテキスト検索は異なる方法で実行できます。

パターンを正規表現として使用すると、これらが最も常用の方法です：

例 説明
text.match(パターン) 文字列メソッド match()
text.search(パターン) 文字列メソッド search()
パターン.exec(text) 正規表現メソッド exec()
パターン.test(text) 正規表現メソッド test()

ブラウザのサポート

match() ECMAScript1 (ES1) の機能です。

すべてのブラウザが完全にサポート ES1 (JavaScript 1997)：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
サポート サポート サポート サポート サポート サポート

関連ページ

JavaScript 文字列

JavaScript 文字列メソッド

JavaScript 文字列検索