【JSリファレンス】Symbol.match

更新日:2024/06/14

Symbol.matchは、Symbolコンストラクターのプロパティです。

既知シンボル(well-known symbol) @@match の実体を返します。
オブジェクトのプロパティ名として既知シンボルを使用すると、そのプロパティが一部の組み込みメソッドまたは演算子から参照されます。

[Symbol.match]プロパティは、String.prototype.match()によって呼び出されます。

プロパティの値として次の関数が想定されます。


文字列を受け取り、何らかの値を返す関数

String.prototype.match()は文字列に正規表現を適用するメソッドのため、独自に作成したオブジェクトの[Symbol.match]()メソッドは正規表現を処理することを期待されます。
しかし、実際には任意の値を返すことができます。
String.prototype.match()は戻り値のチェックを行いません。

 

■使用例

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

console.log( "abc".match( obj ) ); // match
console.log( "def".match( obj ) ); // no match
関連ページ
RegExp.prototype[@@match]()

更新日:2024/06/14

書いた人(管理人):けーちゃん

スポンサーリンク

記事の内容について

null

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

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

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

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

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

 

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