【JSリファレンス】String.prototype.match()

更新日：2024/06/14

String.prototype.match()は、Stringオブジェクト(Stringコンストラクターのインスタンス)のプロトタイプチェーンに組み込まれるメソッドです。

引数としてRegExpオブジェクトを受け取り、対象の文字列に正規表現を適用した結果を返します。

■構文

String.prototype.match ( regexp )

正規表現文字列は、RegExpオブジェクトに変換されます。

正規表現のマッチング処理の本体は、RegExpオブジェクトの[Symbol.match]()メソッドです。
このメソッドは、String.prototype.match( )によって呼び出されます。

実際にはRegExpオブジェクトである必要はなく、[Symbol.match]をプロパティ名を持っていれば他のオブジェクトでも呼び出されます。

String.prototype.match( )は、[Symbol.match]()の戻り値をそのまま返します。
そのため、戻り値は[Symbol.match]()に依存します。

■使用例

▶gフラグがない場合

const rg = /([a-z]\d)/;
console.log( "a1b2".match( rg ) );
 // [ "a1", "a", "1", index: 0, input: "a1b2", groups: undefined ]

▶gフラグがある場合

const rg = /([a-z])(\d)/g;
console.log( "a1b2".match( rg ) );
  // [ "a1", "b2" ]

▶RegExpオブジェクトでない場合

const obj = {
    [Symbol.match]: function(value) {
        return value.indexOf( "a" ) >= 0 ?
                "match" : "no match";
    }
};

console.log( "abc".match( obj ) ); // "match"
console.log( "def".match( obj ) ); // "no match"

関連ページ

スポンサーリンク

記事の内容について

こんにちはけーちゃんです。
説明するのって難しいですね。

「なんか言ってることおかしくない？」
たぶん、こんなご意見あると思います。

裏付けを取りながら記事を作成していますが、僕の勘違いだったり、そもそも情報源の内容が間違えていたりで、正確でないことが多いと思います。
そんなときは、ご意見もらえたら嬉しいです。

掲載コードについては事前に動作確認をしていますが、貼り付け後に体裁を整えるなどをした結果動作しないものになっていることがあります。
生暖かい視線でスルーするか、ご指摘ください。

ご意見、ご指摘はこちら。
https://jsref.affi-sapo-sv.com/info.php

 

このサイトは、リンクフリーです。大歓迎です。