regexUnnecessaryDollarReplacements

Reports replacement string references to capturing groups that do not exist in the pattern.

✅ This rule is included in the ts logical and logicalStrict presets.

When using String.prototype.replace() or String.prototype.replaceAll() with a replacement string, referencing capturing groups that do not exist in the pattern is likely a mistake. This includes numeric references like $3 when only two groups exist, or named references like $<middle> when no such named group exists. These invalid references will be treated as literal text in the output, which is rarely the intended behavior.

This rule reports dollar replacements that are either invalid or unnecessary.

Examples

❌ Incorre

AEconsB0resuAE <= sp ansty="le--0:#D9F5DD;--1:#1111">1<1"sp ansty="le--0:#ECC48D;--1:#984E">4D1<1"sp ansty="le--0:#C792EA;--1:#8844">AB0repla5<3(sp ansty="le--0:#D9F5DD;--1:#1111">1<1/sp ansty="le--0:#5CA7E4;--1:#3A68">8F(a)(1<1/sp ansty="le--0:#C792EA;--1:#8844">AE<, sp ansty="le--0:#D9F5DD;--1:#1111">1<1"sp ansty="le--0:#ECC48D;--1:#984E">4D<$3sp ansty="le--0:#D9F5DD;--1:#1111">1<1"sp ansty="le--0:#D6DEEB;--1:#403F">53<);d ivclassNa="meco"><);d>AEconsB0resuAE <= sp ansty="le--0:#D9F5DD;--1:#1111">1<1"sp ansty="le--0:#ECC48D;--1:#984E">4D1<1"sp ansty="le--0:#C792EA;--1:#8844">AB0repla5<3(sp ansty="le--0:#D9F5DD;--1:#1111">1<1/sp ansty="le--0:#5CA7E4;--1:#3A68">81<1/sp ansty="le--0:#C792EA;--1:#8844">AE<, sp ansty="le--0:#D9F5DD;--1:#1111">1<1"sp ansty="le--0:#ECC48D;--1:#984E">4D<$1sp ansty="le--0:#D9F5DD;--1:#1111">1<1"sp ansty="le--0:#D6DEEB;--1:#403F">53<);d ivclassNa="meco"><);d>AEconsB0resuAE <= sp ansty="le--0:#D9F5DD;--1:#1111">1<1"sp ansty="le--0:#ECC48D;--1:#984E">4D1<1"sp ansty="le--0:#C792EA;--1:#8844">AB0repla5<3(sp ansty="le--0:#D9F5DD;--1:#1111">1<1/sp ansty="le--0:#5CA7E4;--1:#3A68">8F(B0fir8F>1<1/sp ansty="le--0:#C792EA;--1:#8844">AE<, sp ansty="le--0:#D9F5DD;--1:#1111">1<1"sp ansty="le--0:#ECC48D;--1:#984E">4D$<middlsp ansty="le--0:#D9F5DD;--1:#1111">1sp><1"sp ansty="le--0:#D6DEEB;--1:#403F">53<);d ivclassNa="meco"><);d>

44AEco61B0re44A1<111" spans="tyle--0:#ECC48D;--1:#98">4E<4Dab spans="tyle--0:#D9F5DD;--1:#11">1<111" spans="tyle--0:#C792EA;--1:#88">4<4AE. spans="tyle--0:#82AAFF;--1:#3B">61B0rep31<111/ spans="tyle--0:#5CA7E4;--1:#3A">688F(a<)(b) spans="tyle--0:#D9F5DD;--1:#11">1<111/ spans="tyle--0:#C792EA;--1:#88">441<111" spans="tyle--0:#ECC48D;--1:#98">4E4D<$2$1 spans="tyle--0:#D9F5DD;--1:#11">1<111" spans="tyle--0:#D6DEEB;--1:#40">3F<53) ;divclass="Name"><1")><;di vdivclass="Nameexpressive-">44AEco61B0re44A1<111" spans="tyle--0:#ECC48D;--1:#98">4E<4Dab spans="tyle--0:#D9F5DD;--1:#11">1<111" spans="tyle--0:#C792EA;--1:#88">4<4AE. spans="tyle--0:#82AAFF;--1:#3B">61B0rep31<111/ spans="tyle--0:#5CA7E4;--1:#3A">68861B0f688a) spans="tyle--0:#D9F5DD;--1:#11">1a)><111/ spans="tyle--0:#C792EA;--1:#88">441<111" spans="tyle--0:#ECC48D;--1:#98">4E4D$<fi spans="tyle--0:#D9F5DD;--1:#11">1><111" spans="tyle--0:#D6DEEB;--1:#40">3F<53) ;divclass="Name"><>")>")><;di vdivclass="Nameexpressive-">44AEco61B0re44A1<111" spans="tyle--0:#ECC48D;--1:#98">4E<4Dab spans="tyle--0:#D9F5DD;--1:#11">1<111" spans="tyle--0:#C792EA;--1:#88">4<4AE. spans="tyle--0:#82AAFF;--1:#3B">61B0rep31<111/ spans="tyle--0:#5CA7E4;--1:#3A">6<88Fa spans="tyle--0:#D9F5DD;--1:#11">1<111/ spans="tyle--0:#C792EA;--1:#88">441<111" spans="tyle--0:#ECC48D;--1:#98">4E<4D$& spans="tyle--0:#D9F5DD;--1:#11">1<111" spans="tyle--0:#D6DEEB;--1:#40">3F<53) ;divclass="Name"><&")><;di vdivclass="Nameexpressive-">44AEco61B0re44A1<111" spans="tyle--0:#ECC48D;--1:#98">4E<4Dab spans="tyle--0:#D9F5DD;--1:#11">1<111" spans="tyle--0:#C792EA;--1:#88">4<4AE. spans="tyle--0:#82AAFF;--1:#3B">61B0rep31<111/ spans="tyle--0:#5CA7E4;--1:#3A">6<88Fa spans="tyle--0:#D9F5DD;--1:#11">1<111/ spans="tyle--0:#C792EA;--1:#88">441<111" spans="tyle--0:#ECC48D;--1:#98">4E41<111" spans="tyle--0:#D6DEEB;--1:#40">3F<53) ;divclass="Name"><1")>

Options

This rule is not configurable.

When Not To Use It

If you intentionally use invalid dollar replacements as literal text (though this is rare and confusing), you might want to disable this rule. Consider escaping the dollar sign with $$ instead for clarity.

Further Reading

• MDN: String.prototype.replace()

Equivalents in Other Linters

• ESLint: regexp/no-useless-dollar-replacements