【JSリファレンス】RegExp.prototype[@@matchAll]()

更新日:2024/06/14

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

@@matchAllは仕様上の表記です。
プログラムコード上では、Symbol.matchAll に置き換えられます。

RegExp.prototype[Symbol.matchAll]()は、イテレーターを返します。
イテレーターは、RegExp.prototype.exec()と同等の結果を返します。
gフラグが指定されている場合は、繰り返しRegExp.prototype.exec()が呼び出されます。

 

■構文

RegExp.prototype [ Symbol.matchAll ] ( string )
  1. string: 解析対象の文字列
マッチング結果を順番に返すイテレーター

 

■使用例

const rg1 = /(\d)(\d)/g;
const rg2 = /(\d)(\d)/;

const t = "a12a34bc";

console.log( [...rg1[Symbol.matchAll]( t )] );
  // [
  //   [ '12', '1', '2', index: 1, input: 'a12a34bc', groups: undefined ],
  //   [ '34', '3', '4', index: 4, input: 'a12a34bc', groups: undefined ]
  // ]

console.log( [...rg2[Symbol.matchAll]( t )] );
  // [
  //   [ '12', '1', '2', index: 1, input: 'a12a34bc', groups: undefined ]
  // ]

 

■備考

String.prototype.matchAll()の引数にRegExpオブジェクトを指定したとき、このメソッドが呼び出されます。
String.prototype.matchAll()は、その結果をそのまま返します。

更新日:2024/06/14

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

スポンサーリンク

記事の内容について

null

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

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

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

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

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

 

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