【JavaScript ECMAScript】Symbol::Symbol.match静的データプロパティの使い方

Symbol.matchプロパティは、JavaScriptにおいて、特定のオブジェクトが正規表現のように振る舞い、文字列を照合（マッチング）する際の挙動を定義するために使われる、特殊なシンボル値を持つプロパティです。

このプロパティはSymbolオブジェクトの静的データプロパティであり、主にString.prototype.match()メソッドの動作をカスタマイズする目的で利用されます。例えば、String.prototype.match()メソッドに引数としてオブジェクトが渡された際、JavaScriptエンジンはそのオブジェクトがSymbol.matchという名前のプロパティを持っているかを確認します。もしこのプロパティが存在し、かつ関数（メソッド）が設定されていれば、String.prototype.match()はその関数を呼び出し、文字列のマッチング処理を実行させます。

これにより、開発者は正規表現オブジェクト（RegExp）だけでなく、独自のルールに基づいた文字列照合ロジックを持つオブジェクトを作成し、それをString.prototype.match()メソッドで利用できるようになります。例えば、日付形式や特定のパターンに一致するかを判定するカスタムオブジェクトを、標準のmatchメソッドを通じて簡単に扱えるようになります。これは、JavaScriptの組み込みメソッドの振る舞いを柔軟に拡張するための強力なメカニズムです。

Copy
1const customMatcher = {
2  [Symbol.match](str) {
3    if (str.includes('example')) {
4      return ['example'];
5    }
6    return null;
7  }
8};
9
10const targetString = "This is an example string.";
11const matchResult = targetString.match(customMatcher);

引数なし

引数はありません

Symbol

Symbol.match は、正規表現マッチング操作で、String.prototype.match() メソッドによって使用されるシンボルです。このプロパティは、常に Symbol 型の値を返します。