Return iterable of RegExpExecArray from RegExp#[Symbol.matchAll] (#60516)

lionel-rowe · jakebailey · web-flow · commit 8bb72d2d965a · 2026-02-06T22:21:51.000Z
Co-authored-by: Jake Bailey &lt;5341706+jakebailey@users.noreply.github.com&gt;
diff --git a/src/lib/es2020.symbol.wellknown.d.ts b/src/lib/es2020.symbol.wellknown.d.ts
@@ -19,5 +19,5 @@ interface RegExp {
      * containing the results of that search.
      * @param string A string to search within.
      */
-    [Symbol.matchAll](str: string): RegExpStringIterator<RegExpMatchArray>;
+    [Symbol.matchAll](str: string): RegExpStringIterator<RegExpExecArray>;
 }
diff --git a/tests/baselines/reference/regexMatchAll-esnext.types b/tests/baselines/reference/regexMatchAll-esnext.types
@@ -2,12 +2,12 @@
 
 === regexMatchAll-esnext.ts ===
 const matches = /\w/g[Symbol.matchAll]("matchAll");
->matches : RegExpStringIterator<RegExpMatchArray>
->        : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
->/\w/g[Symbol.matchAll]("matchAll") : RegExpStringIterator<RegExpMatchArray>
->                                   : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
->/\w/g[Symbol.matchAll] : (str: string) => RegExpStringIterator<RegExpMatchArray>
->                       : ^   ^^      ^^^^^                                      
+>matches : RegExpStringIterator<RegExpExecArray>
+>        : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+>/\w/g[Symbol.matchAll]("matchAll") : RegExpStringIterator<RegExpExecArray>
+>                                   : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+>/\w/g[Symbol.matchAll] : (str: string) => RegExpStringIterator<RegExpExecArray>
+>                       : ^   ^^      ^^^^^                                     
 >/\w/g : RegExp
 >      : ^^^^^^
 >Symbol.matchAll : unique symbol
@@ -20,24 +20,24 @@ const matches = /\w/g[Symbol.matchAll]("matchAll");
 >           : ^^^^^^^^^^
 
 const array = [...matches];
->array : RegExpMatchArray[]
->      : ^^^^^^^^^^^^^^^^^^
->[...matches] : RegExpMatchArray[]
->             : ^^^^^^^^^^^^^^^^^^
->...matches : RegExpMatchArray
->           : ^^^^^^^^^^^^^^^^
->matches : RegExpStringIterator<RegExpMatchArray>
->        : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+>array : RegExpExecArray[]
+>      : ^^^^^^^^^^^^^^^^^
+>[...matches] : RegExpExecArray[]
+>             : ^^^^^^^^^^^^^^^^^
+>...matches : RegExpExecArray
+>           : ^^^^^^^^^^^^^^^
+>matches : RegExpStringIterator<RegExpExecArray>
+>        : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 const { index, input } = array[0];
->index : number | undefined
->      : ^^^^^^^^^^^^^^^^^^
->input : string | undefined
->      : ^^^^^^^^^^^^^^^^^^
->array[0] : RegExpMatchArray
->         : ^^^^^^^^^^^^^^^^
->array : RegExpMatchArray[]
->      : ^^^^^^^^^^^^^^^^^^
+>index : number
+>      : ^^^^^^
+>input : string
+>      : ^^^^^^
+>array[0] : RegExpExecArray
+>         : ^^^^^^^^^^^^^^^
+>array : RegExpExecArray[]
+>      : ^^^^^^^^^^^^^^^^^
 >0 : 0
 >  : ^
 
diff --git a/tests/baselines/reference/regexMatchAll.types b/tests/baselines/reference/regexMatchAll.types
@@ -2,12 +2,12 @@
 
 === regexMatchAll.ts ===
 const matches = /\w/g[Symbol.matchAll]("matchAll");
->matches : RegExpStringIterator<RegExpMatchArray>
->        : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
->/\w/g[Symbol.matchAll]("matchAll") : RegExpStringIterator<RegExpMatchArray>
->                                   : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
->/\w/g[Symbol.matchAll] : (str: string) => RegExpStringIterator<RegExpMatchArray>
->                       : ^   ^^      ^^^^^                                      
+>matches : RegExpStringIterator<RegExpExecArray>
+>        : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+>/\w/g[Symbol.matchAll]("matchAll") : RegExpStringIterator<RegExpExecArray>
+>                                   : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+>/\w/g[Symbol.matchAll] : (str: string) => RegExpStringIterator<RegExpExecArray>
+>                       : ^   ^^      ^^^^^                                     
 >/\w/g : RegExp
 >      : ^^^^^^
 >Symbol.matchAll : unique symbol
@@ -20,24 +20,24 @@ const matches = /\w/g[Symbol.matchAll]("matchAll");
 >           : ^^^^^^^^^^
 
 const array = [...matches];
->array : RegExpMatchArray[]
->      : ^^^^^^^^^^^^^^^^^^
->[...matches] : RegExpMatchArray[]
->             : ^^^^^^^^^^^^^^^^^^
->...matches : RegExpMatchArray
->           : ^^^^^^^^^^^^^^^^
->matches : RegExpStringIterator<RegExpMatchArray>
->        : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+>array : RegExpExecArray[]
+>      : ^^^^^^^^^^^^^^^^^
+>[...matches] : RegExpExecArray[]
+>             : ^^^^^^^^^^^^^^^^^
+>...matches : RegExpExecArray
+>           : ^^^^^^^^^^^^^^^
+>matches : RegExpStringIterator<RegExpExecArray>
+>        : ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 const { index, input } = array[0];
->index : number | undefined
->      : ^^^^^^^^^^^^^^^^^^
->input : string | undefined
->      : ^^^^^^^^^^^^^^^^^^
->array[0] : RegExpMatchArray
->         : ^^^^^^^^^^^^^^^^
->array : RegExpMatchArray[]
->      : ^^^^^^^^^^^^^^^^^^
+>index : number
+>      : ^^^^^^
+>input : string
+>      : ^^^^^^
+>array[0] : RegExpExecArray
+>         : ^^^^^^^^^^^^^^^
+>array : RegExpExecArray[]
+>      : ^^^^^^^^^^^^^^^^^
 >0 : 0
 >  : ^
 

Original file line number	Diff line number	Diff line change
`@@ -19,5 +19,5 @@ interface RegExp {`
`19`	`19`	`* containing the results of that search.`
`20`	`20`	`* @param string A string to search within.`
`21`	`21`	`*/`
`22`		`- [Symbol.matchAll](str: string): RegExpStringIterator<RegExpMatchArray>;`
	`22`	`+ [Symbol.matchAll](str: string): RegExpStringIterator<RegExpExecArray>;`
`23`	`23`	`}`