Mention regex route behavior with i18n (#22500)

This mentions how locale routes are transformed when `locale: false` is not used to explain why regex routes might not match with i18n. Closes: #21507
vercel · Feb 24, 2021 · d9bb645 · d9bb645
1 parent b90b4b5
commit d9bb645
Show file tree

Hide file tree

Showing 3 changed files with 24 additions and 0 deletions.
diff --git a/docs/api-reference/next.config.js/headers.md b/docs/api-reference/next.config.js/headers.md
@@ -227,6 +227,17 @@ module.exports = {
           },
         ],
       },
+      {
+        // this gets converted to /(en|fr|de)/(.*) so will not match the top-level
+        // `/` or `/fr` routes like /:path* would
+        source: '/(.*)',
+        headers: [
+          {
+            key: 'x-hello',
+            value: 'worlld',
+          },
+        ],
+      },
     ]
   },
 }

diff --git a/docs/api-reference/next.config.js/redirects.md b/docs/api-reference/next.config.js/redirects.md
@@ -152,6 +152,13 @@ module.exports = {
         locale: false,
         permanent: false,
       },
+      {
+        // this gets converted to /(en|fr|de)/(.*) so will not match the top-level
+        // `/` or `/fr` routes like /:path* would
+        source: '/(.*)',
+        destination: '/another',
+        permanent: false,
+      },
     ]
   },
 }

diff --git a/docs/api-reference/next.config.js/rewrites.md b/docs/api-reference/next.config.js/rewrites.md
@@ -244,6 +244,12 @@ module.exports = {
         destination: '/en/another',
         locale: false,
       },
+      {
+        // this gets converted to /(en|fr|de)/(.*) so will not match the top-level
+        // `/` or `/fr` routes like /:path* would
+        source: '/(.*)',
+        destination: '/another',
+      },
     ]
   },
 }