https://babeljs.io/assets/js/6d708239.95761142.js

1"use strict";(self.webpackChunk=self.webpackChunk||[]).push([["17635"],{64520:function(e,n,r){r.r(n),r.d(n,{metadata:function(){return t},default:function(){return g},frontMatter:function(){return u},contentTitle:function(){return o},toc:function(){return d},assets:function(){return c}});var t=JSON.parse('{"id":"babel-plugin-transform-duplicate-named-capturing-groups-regex","title":"@babel/plugin-transform-duplicate-named-capturing-groups-regex","description":"This plugin is included in @babel/preset-env, in ES2025.","source":"@site/../docs/plugin-transform-duplicate-named-capturing-groups-regex.md","sourceDirName":".","slug":"/babel-plugin-transform-duplicate-named-capturing-groups-regex","permalink":"/docs/babel-plugin-transform-duplicate-named-capturing-groups-regex","draft":false,"unlisted":false,"editUrl":"https://github.com/babel/website/edit/main/docs/../docs/plugin-transform-duplicate-named-capturing-groups-regex.md","tags":[],"version":"current","frontMatter":{"id":"babel-plugin-transform-duplicate-named-capturing-groups-regex","title":"@babel/plugin-transform-duplicate-named-capturing-groups-regex","sidebar_label":"duplicate-named-capturing-groups-regex"},"sidebar":"docs","previous":{"title":"explicit-resource-management","permalink":"/docs/babel-plugin-transform-explicit-resource-management"},"next":{"title":"json-modules","permalink":"/docs/babel-plugin-transform-json-modules"}}'),a=r(62540),i=r(43023),l=r(77779),s=r(98263);let u={id:"babel-plugin-transform-duplicate-named-capturing-groups-regex",title:"@babel/plugin-transform-duplicate-named-capturing-groups-regex",sidebar_label:"duplicate-named-capturing-groups-regex"},o,c={},d=[{value:"Examples",id:"examples",level:2},{value:"Installation",id:"installation",level:2},{value:"Usage",id:"usage",level:2},{value:"With a configuration file (Recommended)",id:"with-a-configuration-file-recommended",level:3},{value:"Via CLI",id:"via-cli",level:3},{value:"Via Node API",id:"via-node-api",level:3},{value:"Options",id:"options",level:2},{value:"<code>runtime</code>",id:"runtime",level:3},{value:"References",id:"references",level:2}];function p(e){let n={a:"a",admonition:"admonition",code:"code",em:"em",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,i.R)(),...e.components};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(n.admonition,{type:"info",children:(0,a.jsxs)(n.p,{children:["This plugin is included in ",(0,a.jsx)(n.code,{children:"@babel/preset-env"}),", in ",(0,a.jsx)(n.a,{href:"https://github.com/tc39/proposals/blob/master/finished-proposals.md",children:"ES2025"}),"."]})}),"\n",(0,a.jsxs)(n.p,{children:["This plugin transforms regular expression ",(0,a.jsx)(n.em,{children:"literals"})," to support duplicate named capturing groups. It does not patch the ",(0,a.jsx)(n.code,{children:"new RegExp"})," constructor, since its arguments cannot be pre-transformed statically: to handle runtime behavior of functions/classes, you will need to use a polyfill instead."]}),"\n",(0,a.jsx)(n.h2,{id:"examples",children:"Examples"}),"\n",(0,a.jsx)(n.p,{children:(0,a.jsx)(n.strong,{children:"In"})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-js",metastring:'title="JavaScript"',children:'var re = /(?<year>\\d{4})-(?<month>\\d{2})|(?<month>\\d{2})-(?<year>\\d{4})/;\n\nconsole.log(re.exec("02-1999").groups.year);\n'})}),"\n",(0,a.jsx)(n.p,{children:(0,a.jsx)(n.strong,{children:"Out"})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-js",metastring:'title="JavaScript"',children:'var re = _wrapRegExp(/(\\d{4})-(\\d{2})|(\\d{2})-(\\d{4})/, {\n  year: [1, 4],\n  month: [2, 3],\n});\n\nconsole.log(re.exec("02-1999").groups.year);\n'})}),"\n",(0,a.jsx)(n.h2,{id:"installation",children:"Installation"}),"\n",(0,a.jsxs)(l.A,{groupId:"npm2yarn",children:[(0,a.jsx)(s.A,{value:"npm",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-shell",children:"npm install --save-dev @babel/plugin-transform-duplicate-named-capturing-groups-regex\n"})})}),(0,a.jsx)(s.A,{value:"yarn",label:"Yarn",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-shell",children:"yarn add 

1--dev @babel/plugin-transform-duplicate-named-capturing-groups-regex\n"})})}),(0,a.jsx)(s.A,{value:"pnpm",label:"pnpm",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-shell",children:"pnpm add --save-dev @babel/plugin-transform-duplicate-named-capturing-groups-regex\n"})})}),(0,a.jsx)(s.A,{value:"bun",label:"Bun",children:(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-shell",children:"bun add --dev @babel/plugin-transform-duplicate-named-capturing-groups-regex\n"})})})]}),"\n",(0,a.jsx)(n.h2,{id:"usage",children:"Usage"}),"\n",(0,a.jsx)(n.h3,{id:"with-a-configuration-file-recommended",children:"With a configuration file (Recommended)"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-json",metastring:'title="babel.config.json"',children:'{\n  "plugins": ["@babel/plugin-transform-duplicate-named-capturing-groups-regex"]\n}\n'})}),"\n",(0,a.jsx)(n.h3,{id:"via-cli",children:"Via CLI"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-sh",metastring:'title="Shell"',children:"babel --plugins @babel/plugin-transform-duplicate-named-capturing-groups-regex script.js\n"})}),"\n",(0,a.jsx)(n.h3,{id:"via-node-api",children:"Via Node API"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-js",metastring:'title="JavaScript"',children:'require("@babel/core").transformSync("code", {\n  plugins: ["@babel/plugin-transform-duplicate-named-capturing-groups-regex"],\n});\n'})}),"\n",(0,a.jsx)(n.h2,{id:"options",children:"Options"}),"\n",(0,a.jsx)(n.h3,{id:"runtime",children:(0,a.jsx)(n.code,{children:"runtime"})}),"\n",(0,a.jsxs)(n.p,{children:[(0,a.jsx)(n.code,{children:"boolean"}),", defaults to ",(0,a.jsx)(n.code,{children:"true"})]}),"\n",(0,a.jsxs)(n.p,{children:["When this option is disabled, Babel doesn't wrap RegExps with the ",(0,a.jsx)(n.code,{children:"_wrapRegExp"})," helper.\nThe output only supports internal group references, and not runtime properties:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-js",metastring:'title="JavaScript"',children:'var stringRe = /(?:(?<quote>")|(?<quote>\')).*?\\k<quote>/;\n\nstringRe.test("\'foo\'"); // "true", works\nstringRe.exec("\'foo\'").groups.quote; // undefined\n'})}),"\n",(0,a.jsx)(n.admonition,{type:"tip",children:(0,a.jsxs)(n.p,{children:["You can read more about configuring plugin options ",(0,a.jsx)(n.a,{href:"/docs/plugins#plugin-options",children:"here"})]})}),"\n",(0,a.jsx)(n.h2,{id:"references",children:"References"}),"\n",(0,a.jsxs)(n.ul,{children:["\n",(0,a.jsx)(n.li,{children:(0,a.jsx)(n.a,{href:"https://github.com/tc39/proposal-duplicate-named-capturing-groups",children:"Proposal: Duplicate named capturing groups"})}),"\n"]})]})}function g(e={}){let{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,a.jsx)(n,{...e,children:(0,a.jsx)(p,{...e})}):p(e)}},98263:function(e,n,r){r.d(n,{A:function(){return s}});var t=r(62540);r(63696);var a=r(11750),i=r(23865);function l({children:e,className:n,hidden:r}){return(0,t.jsx)("div",{role:"tabpanel",className:(0,a.A)("tabItem_wHwb",n),hidden:r,children:e})}function s({children:e,className:n,value:r}){let{selectedValue:a,lazy:u}=(0,i.uc)(),o=r===a;return!o&&u?null:(0,t.jsx)(l,{className:n,hidden:!o,children:e})}},77779:function(e,n,r){r.d(n,{A:function(){return p}});var t=r(62540);r(63696);var a=r(11750),i=r(46065),l=r(23865),s=r(45194),u=r(83029);function o({className:e}){let{selectedValue:n,selectValue:r,tabValues:i,block:u}=(0,l.uc)(),c=[],{blockElementScrollPositionUntilNextRender:d}=(0,s.a_)(),p=e=>{let t=e.currentTarget,a=i[c.indexOf(t)].value;a!==n&&(d(t),r(a))},g=e=>{let n=null;switch(e.key){case"Enter":p(e);break;case"ArrowRight":{let r=c.indexOf(e.currentTarget)+1;n=c[r]??c[0];break}case"ArrowLeft":{let r=c.indexOf(e.currentTarget)-1;n=c[r]??c[c.length-1]}}n?.focus()};return(0,t.jsx)("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,a.A)("tabs",{"tabs--block":u},e),children:i.map(({value:e,label:r,attributes:i})=>(0,t.jsx)("li",{role:"tab",tabIndex:n===e?0:-1,"aria-selected":n===e,ref:e=>{c.push(e)},onKeyDown:g,onClick:p,...i,className:(0,a.A)("tabs__item","tabItem_l0OV",i?.className,{"tabs__item--active":n===e}),children:r??e},e))})}function c({children:e}){return(0,t.jsx)("div",{className:"margin-top--md",children:e})}function d({className:e,children:n}){return(0,t.jsxs)("div",{className:(0,a.A)(i.G.tabs.container,"tabs-container","tabList_J5MA"),children:[(0,t.jsx)(o,{className:e}),(0,t.jsx)(c,{children:n})]})}function p(e){let n=(0,u.A)(),r=(0,l.OC)(e);return(0,t.jsx)(l.O_,{value:r,children:(0,t.jsx)(d,{className:e.className,children:(0,l.vT)(e.children)})},String(n))}},23865:function(e,n,r){r.d(n,{OC:function(){return p},O_:function(){return m},uc:function(){return h},vT:function(){return c}});var t=r(62540),a=r(63696),i=r(49519),l=r(6743),s=r(88511),u=r(15396),o=r(89030);function c(e){return a.Children.toArray(e).filter(e=>"\n"!==e)}function d({value:e,tabValues:n}){return n.some(n=>n.value===e)}function p(e){let n,{defaultValue:r,queryString:t=!1,groupId:c}=e,p=function(e){let{values:n,children:r}=e;return(0,a.useMemo)(()=>{let e=n??a.Children.toArray(r).flatMap(e=>{if(!e)return[];if((0,a.isValidElement)(e)&&function(e){let{props:n}=e;return!!n&&"object"==typeof n&&"value"in n}(e))return[e];

1let n="string"==typeof e.type?e.type:e.type.name;throw Error(`Docusaurus error: Bad <Tabs> child <${n}>: all children of the <Tabs> component should be <TabItem>, and every <TabItem> should have a unique "value" prop.
2If you do not want to pass on a "value" prop to the direct children of <Tabs>, you can also pass an explicit <Tabs values={...}> prop.`)}).map(({props:{value:e,label:n,attributes:r,default:t}})=>({value:e,label:n,attributes:r,default:t})),t=(0,u.XI)(e,(e,n)=>e.value===n.value);if(t.length>0)throw Error(`Docusaurus error: Duplicate values "${t.map(e=>`'${e.value}'`).join(", ")}" found in <Tabs>. Every value needs to be unique.`);return e},[n,r])}(e),[g,h]=(0,a.useState)(()=>(function({defaultValue:e,tabValues:n}){if(0===n.length)throw Error("Docusaurus error: the <Tabs> component requires at least one <TabItem> children component");if(e){if(!d({value:e,tabValues:n}))throw Error(`Docusaurus error: The <Tabs> has a defaultValue "${e}" but none of its children has the corresponding value. Available values are: ${n.map(e=>e.value).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return e}let r=n.find(e=>e.default)??n[0];if(!r)throw Error("Unexpected error: 0 tabValues");return r.value})({defaultValue:r,tabValues:p})),[m,f]=function({queryString:e=!1,groupId:n}){let r=(0,i.W6)(),t=function({queryString:e=!1,groupId:n}){if("string"==typeof e)return e;if(!1===e)return null;if(!0===e&&!n)throw Error('Docusaurus error: The <Tabs> component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return n??null}({queryString:e,groupId:n});return[(0,s.aZ)(t),(0,a.useCallback)(e=>{if(!t)return;let n=new URLSearchParams(r.location.search);n.set(t,e),r.replace({...r.location,search:n.toString()})},[t,r])]}({queryString:t,groupId:c}),[x,b]=function({groupId:e}){let n=e?`docusaurus.tab.${e}`:null,[r,t]=(0,o.Dv)(n);return[r,(0,a.useCallback)(e=>{n&&t.set(e)},[n,t])]}({groupId:c}),v=d({value:n=m??x,tabValues:p})?n:null;return(0,l.A)(()=>{v&&h(v)},[v]),{selectedValue:g,selectValue:(0,a.useCallback)(e=>{if(!d({value:e,tabValues:p}))throw Error(`Can't select invalid tab value=${e}`);h(e),f(e),b(e)},[f,b,p]),tabValues:p,lazy:e.lazy??!1,block:e.block??!1}}let g=(0,a.createContext)(null);function h(){let e=a.useContext(g);if(!e)throw Error("useTabsContext() must be used within a Tabs component");return e}function m(e){return(0,t.jsx)(g.Provider,{value:e.value,children:e.children})}},43023:function(e,n,r){r.d(n,{R:function(){return l},x:function(){return s}});var t=r(63696);let a={},i=t.createContext(a);function l(e){let n=t.useContext(i);return t.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function s(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(a):e.components||a:l(e.components),t.createElement(i.Provider,{value:n},e.children)}}}]);