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

更新日:2024/06/14

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

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

[Symbol.matchAll]プロパティは、String.prototype.matchAll()によって呼び出されます。
プロパティの値として次の関数が想定されます。


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

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

 

■使用例

const obj = {
    [Symbol.matchAll]: function*(value) {
        yield* [...value];
    }
};

for( const value of "ab".matchAll( obj ) ){
    console.log( value );
}
// 結果:
// a
// b

▶イテレーターを返さないケース

const obj = {
    [Symbol.matchAll]: function(value) {
        return value.toUpperCase();
    }
};


console.log( "abc".matchAll(obj) );

 

関連ページ

関連ページ
RegExp.prototype[@@matchAll]()

更新日:2024/06/14

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

スポンサーリンク

記事の内容について

null

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

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

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

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

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

 

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