@modern-js/plugin-i18n 3.9.1 → 3.9.3

package/dist/cjs/runtime/i18n/detection/index.js

@@ -253,7 +253,7 @@ const detectLanguageWithPriority = async (i18nInstance, options)=>{
     let detectedLanguage;
     detectedLanguage = detectLanguageFromSSR(languages);
     if (!detectedLanguage) detectedLanguage = detectLanguageFromPathPriority(pathname, languages, localePathRedirect);
-    if (!detectedLanguage && i18nextDetector) detectedLanguage = (0, external_instance_js_namespaceObject.isI18nWrapperInstance)(i18nInstance) ? (0, external_middleware_js_namespaceObject.readLanguageFromStorage)(mergeDetectionOptions(i18nextDetector, detection, localePathRedirect, userInitOptions)) : await detectLanguageFromI18nextDetector(i18nInstance, {
+    if (!detectedLanguage && i18nextDetector) detectedLanguage = (0, external_instance_js_namespaceObject.isI18nWrapperInstance)(i18nInstance) ? (0, external_middleware_js_namespaceObject.readLanguageFromStorage)(mergeDetectionOptions(i18nextDetector, detection, localePathRedirect, userInitOptions), ssrContext?.request, languages) : await detectLanguageFromI18nextDetector(i18nInstance, {
         languages,
         fallbackLanguage,
         localePathRedirect,

package/dist/cjs/runtime/i18n/detection/middleware.js

@@ -56,7 +56,7 @@ const useI18nextLanguageDetector = (i18nInstance)=>{
     }
     return i18nInstance;
 };
-const readLanguageFromStorage = (detectionOptions)=>{
+const readLanguageFromStorage = (detectionOptions, _request, _languages)=>{
     try {
         const options = detectionOptions || {};
         const order = options.order || [

package/dist/cjs/runtime/i18n/detection/middleware.node.js

@@ -34,8 +34,13 @@ __webpack_require__.d(__webpack_exports__, {
     useI18nextLanguageDetector: ()=>useI18nextLanguageDetector
 });
 const external_i18next_http_middleware_namespaceObject = require("i18next-http-middleware");
+const detection_js_namespaceObject = require("../../../shared/detection.js");
 const cacheUserLanguage = (_i18nInstance, _language, _detectionOptions)=>{};
-const readLanguageFromStorage = (_detectionOptions)=>{};
+const readLanguageFromStorage = (detectionOptions, request, languages = [])=>{
+    if (!request) return;
+    const detectedLanguage = (0, detection_js_namespaceObject.detectLanguageFromRequest)(request, languages, detectionOptions);
+    return detectedLanguage ?? void 0;
+};
 const useI18nextLanguageDetector = (i18nInstance)=>{
     if (!i18nInstance.isInitialized) return i18nInstance.use(external_i18next_http_middleware_namespaceObject.LanguageDetector);
     return i18nInstance;

package/dist/cjs/shared/detection.js

@@ -47,8 +47,11 @@ function detectLanguageFromRequest(req, languages, detectionOptions) {
             'header'
         ];
         const getHeader = (name)=>{
-            req.headers, Headers;
-            return req.headers.get(name);
+            const headers = req.headers;
+            if ('function' == typeof headers?.get) return headers.get(name);
+            const value = headers[name.toLowerCase()];
+            if (Array.isArray(value)) return value[0] ?? null;
+            return value ?? null;
         };
         for (const method of detectionOrder){
             let detectedLang = null;
@@ -83,19 +86,30 @@ function detectLanguageFromRequest(req, languages, detectionOptions) {
                             const languagesList = acceptLanguage.split(',').map((lang)=>{
                                 const [code, q] = lang.trim().split(';');
                                 return {
-                                    code: code.split('-')[0],
+                                    code,
+                                    baseCode: code.split('-')[0],
                                     quality: q ? parseFloat(q.split('=')[1]) : 1.0
                                 };
                             }).sort((a, b)=>b.quality - a.quality);
-                            for (const lang of languagesList)if (0 === languages.length || languages.includes(lang.code)) {
-                                detectedLang = lang.code;
-                                break;
+                            for (const lang of languagesList){
+                                if (0 === languages.length || languages.includes(lang.code)) {
+                                    detectedLang = lang.code;
+                                    break;
+                                }
+                                if (languages.includes(lang.baseCode)) {
+                                    detectedLang = lang.baseCode;
+                                    break;
+                                }
                             }
                         }
                         break;
                     }
             }
             if (detectedLang && (0 === languages.length || languages.includes(detectedLang))) return detectedLang;
+            if (detectedLang) {
+                const baseLang = detectedLang.split('-')[0];
+                if (languages.includes(baseLang)) return baseLang;
+            }
         }
     } catch (error) {}
     return null;

package/dist/esm/runtime/i18n/detection/index.mjs

@@ -216,7 +216,7 @@ const detectLanguageWithPriority = async (i18nInstance, options)=>{
     let detectedLanguage;
     detectedLanguage = detectLanguageFromSSR(languages);
     if (!detectedLanguage) detectedLanguage = detectLanguageFromPathPriority(pathname, languages, localePathRedirect);
-    if (!detectedLanguage && i18nextDetector) detectedLanguage = isI18nWrapperInstance(i18nInstance) ? readLanguageFromStorage(detection_mergeDetectionOptions(i18nextDetector, detection, localePathRedirect, userInitOptions)) : await detectLanguageFromI18nextDetector(i18nInstance, {
+    if (!detectedLanguage && i18nextDetector) detectedLanguage = isI18nWrapperInstance(i18nInstance) ? readLanguageFromStorage(detection_mergeDetectionOptions(i18nextDetector, detection, localePathRedirect, userInitOptions), ssrContext?.request, languages) : await detectLanguageFromI18nextDetector(i18nInstance, {
         languages,
         fallbackLanguage,
         localePathRedirect,

package/dist/esm/runtime/i18n/detection/middleware.mjs

@@ -11,7 +11,7 @@ const useI18nextLanguageDetector = (i18nInstance)=>{
     }
     return i18nInstance;
 };
-const readLanguageFromStorage = (detectionOptions)=>{
+const readLanguageFromStorage = (detectionOptions, _request, _languages)=>{
     try {
         const options = detectionOptions || {};
         const order = options.order || [

package/dist/esm/runtime/i18n/detection/middleware.node.mjs

@@ -1,6 +1,11 @@
 import { LanguageDetector } from "i18next-http-middleware";
+import { detectLanguageFromRequest } from "../../../shared/detection.mjs";
 const cacheUserLanguage = (_i18nInstance, _language, _detectionOptions)=>{};
-const readLanguageFromStorage = (_detectionOptions)=>{};
+const readLanguageFromStorage = (detectionOptions, request, languages = [])=>{
+    if (!request) return;
+    const detectedLanguage = detectLanguageFromRequest(request, languages, detectionOptions);
+    return detectedLanguage ?? void 0;
+};
 const useI18nextLanguageDetector = (i18nInstance)=>{
     if (!i18nInstance.isInitialized) return i18nInstance.use(LanguageDetector);
     return i18nInstance;

package/dist/esm/runtime/utils.mjs

@@ -2,7 +2,7 @@ import { isBrowser } from "@modern-js/runtime";
 import { getGlobalBasename } from "@modern-js/runtime/context";
 import { __webpack_require__ } from "../rslib-runtime~1.mjs";
 __webpack_require__.add({
-    4734 (module) {
+    He (module) {
         module.exports = require("@modern-js/runtime/router");
     }
 });
@@ -55,7 +55,7 @@ const shouldIgnoreRedirect = (pathname, languages, ignoreRedirectRoutes)=>{
 };
 const useRouterHooks = ()=>{
     try {
-        const { useLocation, useNavigate, useParams } = __webpack_require__(4734);
+        const { useLocation, useNavigate, useParams } = __webpack_require__("He");
         return {
             navigate: useNavigate(),
             location: useLocation(),

package/dist/esm/shared/detection.mjs

@@ -15,8 +15,11 @@ function detectLanguageFromRequest(req, languages, detectionOptions) {
             'header'
         ];
         const getHeader = (name)=>{
-            req.headers, Headers;
-            return req.headers.get(name);
+            const headers = req.headers;
+            if ('function' == typeof headers?.get) return headers.get(name);
+            const value = headers[name.toLowerCase()];
+            if (Array.isArray(value)) return value[0] ?? null;
+            return value ?? null;
         };
         for (const method of detectionOrder){
             let detectedLang = null;
@@ -51,19 +54,30 @@ function detectLanguageFromRequest(req, languages, detectionOptions) {
                             const languagesList = acceptLanguage.split(',').map((lang)=>{
                                 const [code, q] = lang.trim().split(';');
                                 return {
-                                    code: code.split('-')[0],
+                                    code,
+                                    baseCode: code.split('-')[0],
                                     quality: q ? parseFloat(q.split('=')[1]) : 1.0
                                 };
                             }).sort((a, b)=>b.quality - a.quality);
-                            for (const lang of languagesList)if (0 === languages.length || languages.includes(lang.code)) {
-                                detectedLang = lang.code;
-                                break;
+                            for (const lang of languagesList){
+                                if (0 === languages.length || languages.includes(lang.code)) {
+                                    detectedLang = lang.code;
+                                    break;
+                                }
+                                if (languages.includes(lang.baseCode)) {
+                                    detectedLang = lang.baseCode;
+                                    break;
+                                }
                             }
                         }
                         break;
                     }
             }
             if (detectedLang && (0 === languages.length || languages.includes(detectedLang))) return detectedLang;
+            if (detectedLang) {
+                const baseLang = detectedLang.split('-')[0];
+                if (languages.includes(baseLang)) return baseLang;
+            }
         }
     } catch (error) {}
     return null;

package/dist/esm-node/runtime/i18n/detection/index.mjs

@@ -217,7 +217,7 @@ const detectLanguageWithPriority = async (i18nInstance, options)=>{
     let detectedLanguage;
     detectedLanguage = detectLanguageFromSSR(languages);
     if (!detectedLanguage) detectedLanguage = detectLanguageFromPathPriority(pathname, languages, localePathRedirect);
-    if (!detectedLanguage && i18nextDetector) detectedLanguage = isI18nWrapperInstance(i18nInstance) ? readLanguageFromStorage(detection_mergeDetectionOptions(i18nextDetector, detection, localePathRedirect, userInitOptions)) : await detectLanguageFromI18nextDetector(i18nInstance, {
+    if (!detectedLanguage && i18nextDetector) detectedLanguage = isI18nWrapperInstance(i18nInstance) ? readLanguageFromStorage(detection_mergeDetectionOptions(i18nextDetector, detection, localePathRedirect, userInitOptions), ssrContext?.request, languages) : await detectLanguageFromI18nextDetector(i18nInstance, {
         languages,
         fallbackLanguage,
         localePathRedirect,

package/dist/esm-node/runtime/i18n/detection/middleware.mjs

@@ -12,7 +12,7 @@ const useI18nextLanguageDetector = (i18nInstance)=>{
     }
     return i18nInstance;
 };
-const readLanguageFromStorage = (detectionOptions)=>{
+const readLanguageFromStorage = (detectionOptions, _request, _languages)=>{
     try {
         const options = detectionOptions || {};
         const order = options.order || [

package/dist/esm-node/runtime/i18n/detection/middleware.node.mjs

@@ -1,7 +1,12 @@
 import "node:module";
 import { LanguageDetector } from "i18next-http-middleware";
+import { detectLanguageFromRequest } from "../../../shared/detection.mjs";
 const cacheUserLanguage = (_i18nInstance, _language, _detectionOptions)=>{};
-const readLanguageFromStorage = (_detectionOptions)=>{};
+const readLanguageFromStorage = (detectionOptions, request, languages = [])=>{
+    if (!request) return;
+    const detectedLanguage = detectLanguageFromRequest(request, languages, detectionOptions);
+    return detectedLanguage ?? void 0;
+};
 const useI18nextLanguageDetector = (i18nInstance)=>{
     if (!i18nInstance.isInitialized) return i18nInstance.use(LanguageDetector);
     return i18nInstance;

package/dist/esm-node/shared/detection.mjs

@@ -16,8 +16,11 @@ function detectLanguageFromRequest(req, languages, detectionOptions) {
             'header'
         ];
         const getHeader = (name)=>{
-            req.headers, Headers;
-            return req.headers.get(name);
+            const headers = req.headers;
+            if ('function' == typeof headers?.get) return headers.get(name);
+            const value = headers[name.toLowerCase()];
+            if (Array.isArray(value)) return value[0] ?? null;
+            return value ?? null;
         };
         for (const method of detectionOrder){
             let detectedLang = null;
@@ -52,19 +55,30 @@ function detectLanguageFromRequest(req, languages, detectionOptions) {
                             const languagesList = acceptLanguage.split(',').map((lang)=>{
                                 const [code, q] = lang.trim().split(';');
                                 return {
-                                    code: code.split('-')[0],
+                                    code,
+                                    baseCode: code.split('-')[0],
                                     quality: q ? parseFloat(q.split('=')[1]) : 1.0
                                 };
                             }).sort((a, b)=>b.quality - a.quality);
-                            for (const lang of languagesList)if (0 === languages.length || languages.includes(lang.code)) {
-                                detectedLang = lang.code;
-                                break;
+                            for (const lang of languagesList){
+                                if (0 === languages.length || languages.includes(lang.code)) {
+                                    detectedLang = lang.code;
+                                    break;
+                                }
+                                if (languages.includes(lang.baseCode)) {
+                                    detectedLang = lang.baseCode;
+                                    break;
+                                }
                             }
                         }
                         break;
                     }
             }
             if (detectedLang && (0 === languages.length || languages.includes(detectedLang))) return detectedLang;
+            if (detectedLang) {
+                const baseLang = detectedLang.split('-')[0];
+                if (languages.includes(baseLang)) return baseLang;
+            }
         }
     } catch (error) {}
     return null;

package/dist/types/runtime/i18n/detection/middleware.d.ts

@@ -1,4 +1,5 @@
-import type { I18nInstance } from '../instance.js';
+import type { detectLanguageFromRequest } from '../../../shared/detection.js';
+import type { I18nInstance, LanguageDetectorOptions } from '../instance.js';
 /**
  * Register LanguageDetector plugin to i18n instance
  * Must be called before init() to properly register the detector
@@ -9,7 +10,7 @@ export declare const useI18nextLanguageDetector: (i18nInstance: I18nInstance) =>
  * Read language directly from localStorage/cookie
  * Fallback when detector is not available in services
  */
-export declare const readLanguageFromStorage: (detectionOptions?: any) => string | undefined;
+export declare const readLanguageFromStorage: (detectionOptions?: LanguageDetectorOptions, _request?: Parameters<typeof detectLanguageFromRequest>[0], _languages?: string[]) => string | undefined;
 /**
  * Detect language using i18next-browser-languagedetector
  * For initialized instances without detector in services, manually create a detector instance

package/dist/types/runtime/i18n/detection/middleware.node.d.ts

@@ -1,10 +1,7 @@
-import type { I18nInstance } from '../instance.js';
+import { detectLanguageFromRequest } from '../../../shared/detection.js';
+import type { I18nInstance, LanguageDetectorOptions } from '../instance.js';
 export declare const cacheUserLanguage: (_i18nInstance: I18nInstance, _language: string, _detectionOptions?: any) => void;
-/**
- * Read language directly from storage (localStorage/cookie)
- * Not available in Node.js environment, returns undefined
- */
-export declare const readLanguageFromStorage: (_detectionOptions?: any) => string | undefined;
+export declare const readLanguageFromStorage: (detectionOptions?: LanguageDetectorOptions, request?: Parameters<typeof detectLanguageFromRequest>[0], languages?: string[]) => string | undefined;
 /**
  * Register LanguageDetector plugin to i18n instance
  * Must be called before init() to properly register the detector

package/dist/types/shared/detection.d.ts

@@ -5,7 +5,7 @@ import type { LanguageDetectorOptions } from '../runtime/i18n/instance.js';
  */
 export declare function detectLanguageFromRequest(req: {
     url: string;
-    headers: {
+    headers: Headers | {
         get: (name: string) => string | null;
-    } | Headers;
+    } | Record<string, string | string[] | undefined>;
 }, languages: string[], detectionOptions?: LanguageDetectorOptions): string | null;

package/package.json

@@ -15,7 +15,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.9.1",
+  "version": "3.9.3",
   "engines": {
     "node": ">=20"
   },
@@ -82,22 +82,22 @@
     "@swc/helpers": "^0.5.17",
     "i18next-browser-languagedetector": "^8.2.1",
     "i18next-chained-backend": "^4.6.3",
-    "i18next-fs-backend": "^2.6.7",
+    "i18next-fs-backend": "^2.6.8",
     "i18next-http-backend": "^3.0.6",
-    "i18next-http-middleware": "^3.9.8",
-    "@modern-js/plugin": "3.9.1",
-    "@modern-js/runtime-utils": "3.9.1",
-    "@modern-js/server-runtime": "3.9.1",
-    "@modern-js/server-core": "3.9.1",
-    "@modern-js/types": "3.9.1",
-    "@modern-js/utils": "3.9.1"
+    "i18next-http-middleware": "^3.9.9",
+    "@modern-js/plugin": "3.9.3",
+    "@modern-js/server-core": "3.9.3",
+    "@modern-js/runtime-utils": "3.9.3",
+    "@modern-js/server-runtime": "3.9.3",
+    "@modern-js/types": "3.9.3",
+    "@modern-js/utils": "3.9.3"
   },
   "peerDependencies": {
     "react": ">=18.3.1",
     "react-dom": ">=18.3.1",
     "i18next": ">=25.7.4",
     "react-i18next": ">=15.7.4",
-    "@modern-js/runtime": "^3.9.1"
+    "@modern-js/runtime": "^3.9.2"
   },
   "peerDependenciesMeta": {
     "i18next": {
@@ -108,7 +108,7 @@
     }
   },
   "devDependencies": {
-    "@rslib/core": "1.0.0",
+    "@rslib/core": "1.0.1",
     "@types/node": "^20",
     "i18next": "25.7.4",
     "react": "^19.2.8",
@@ -116,9 +116,9 @@
     "react-i18next": "15.7.4",
     "ts-node": "^10.9.2",
     "typescript": "^5",
-    "@modern-js/app-tools": "3.9.1",
+    "@modern-js/app-tools": "3.9.3",
     "@modern-js/rslib": "2.68.10",
-    "@modern-js/runtime": "3.9.1"
+    "@modern-js/runtime": "3.9.3"
   },
   "sideEffects": false,
   "publishConfig": {

package/rstest.config.mts

@@ -0,0 +1,7 @@
+import { withTestPreset } from '@scripts/rstest-config';
+
+export default withTestPreset({
+  root: __dirname,
+  testEnvironment: 'node',
+  globals: true,
+});

package/src/runtime/i18n/detection/index.ts

@@ -538,6 +538,8 @@ export const detectLanguageWithPriority = async (
           localePathRedirect,
           userInitOptions,
         ),
+        ssrContext?.request,
+        languages,
       );
     } else {
       detectedLanguage = await detectLanguageFromI18nextDetector(i18nInstance, {

package/src/runtime/i18n/detection/middleware.node.ts

@@ -1,5 +1,6 @@
 import { LanguageDetector } from 'i18next-http-middleware';
-import type { I18nInstance } from '../instance';
+import { detectLanguageFromRequest } from '../../../shared/detection.js';
+import type { I18nInstance, LanguageDetectorOptions } from '../instance';
 
 export const cacheUserLanguage = (
   _i18nInstance: I18nInstance,
@@ -9,15 +10,21 @@ export const cacheUserLanguage = (
   return;
 };
 
-/**
- * Read language directly from storage (localStorage/cookie)
- * Not available in Node.js environment, returns undefined
- */
 export const readLanguageFromStorage = (
-  _detectionOptions?: any,
+  detectionOptions?: LanguageDetectorOptions,
+  request?: Parameters<typeof detectLanguageFromRequest>[0],
+  languages: string[] = [],
 ): string | undefined => {
-  // In Node.js environment, storage-based detection is not available
-  return undefined;
+  if (!request) {
+    return undefined;
+  }
+
+  const detectedLanguage = detectLanguageFromRequest(
+    request,
+    languages,
+    detectionOptions,
+  );
+  return detectedLanguage ?? undefined;
 };
 /**
  * Register LanguageDetector plugin to i18n instance

package/src/runtime/i18n/detection/middleware.ts

@@ -1,6 +1,7 @@
 import { isBrowser } from '@modern-js/runtime';
 import LanguageDetector from 'i18next-browser-languagedetector';
-import type { I18nInstance } from '../instance';
+import type { detectLanguageFromRequest } from '../../../shared/detection.js';
+import type { I18nInstance, LanguageDetectorOptions } from '../instance';
 import { getActualI18nextInstance, isI18nWrapperInstance } from '../instance';
 
 /**
@@ -27,7 +28,9 @@ export const useI18nextLanguageDetector = (i18nInstance: I18nInstance) => {
  * Fallback when detector is not available in services
  */
 export const readLanguageFromStorage = (
-  detectionOptions?: any,
+  detectionOptions?: LanguageDetectorOptions,
+  _request?: Parameters<typeof detectLanguageFromRequest>[0],
+  _languages?: string[],
 ): string | undefined => {
   try {
     const options = detectionOptions || {};

package/src/shared/detection.ts

@@ -12,10 +12,9 @@ export function detectLanguageFromRequest(
   req: {
     url: string;
     headers:
-      | {
-          get: (name: string) => string | null;
-        }
-      | Headers;
+      | Headers
+      | { get: (name: string) => string | null }
+      | Record<string, string | string[] | undefined>;
   },
   languages: string[],
   detectionOptions?: LanguageDetectorOptions,
@@ -39,11 +38,21 @@ export function detectLanguageFromRequest(
       order.length > 0 ? order : ['querystring', 'cookie', 'header'];
 
     // Helper to get header value
+    // req.headers is a Fetch API Headers instance when the caller passes the raw
+    // Request (e.g. ssrContext.request.raw), but modern.js's own SSR request object
+    // (ssrContext.request) carries headers as a plain, lower-cased key/value object.
     const getHeader = (name: string): string | null => {
-      if (req.headers instanceof Headers) {
-        return req.headers.get(name);
+      const headers = req.headers;
+      if (typeof (headers as Headers)?.get === 'function') {
+        return (headers as Headers).get(name);
+      }
+      const value = (headers as Record<string, string | string[] | undefined>)[
+        name.toLowerCase()
+      ];
+      if (Array.isArray(value)) {
+        return value[0] ?? null;
       }
-      return req.headers.get(name);
+      return value ?? null;
     };
 
     // Try each detection method in order
@@ -94,7 +103,8 @@ export function detectLanguageFromRequest(
               .map((lang: string) => {
                 const [code, q] = lang.trim().split(';');
                 return {
-                  code: code.split('-')[0], // Extract base language code
+                  code,
+                  baseCode: code.split('-')[0],
                   quality: q ? parseFloat(q.split('=')[1]) : 1.0,
                 };
               })
@@ -103,12 +113,17 @@ export function detectLanguageFromRequest(
                   b.quality - a.quality,
               );
 
-            // Find first matching language
+            // Find first matching language, preferring an exact tag match
+            // (e.g. 'zh-Hant-TW') over the base language code (e.g. 'zh')
             for (const lang of languagesList) {
               if (languages.length === 0 || languages.includes(lang.code)) {
                 detectedLang = lang.code;
                 break;
               }
+              if (languages.includes(lang.baseCode)) {
+                detectedLang = lang.baseCode;
+                break;
+              }
             }
           }
           break;
@@ -122,6 +137,15 @@ export function detectLanguageFromRequest(
       ) {
         return detectedLang;
       }
+
+      // Match query and cookie values like header values: exact tag first,
+      // then the supported base language (e.g. 'zh-CN' -> 'zh').
+      if (detectedLang) {
+        const baseLang = detectedLang.split('-')[0];
+        if (languages.includes(baseLang)) {
+          return baseLang;
+        }
+      }
     }
   } catch (error) {
     // Silently ignore errors

package/tests/detection.test.ts

@@ -0,0 +1,37 @@
+import { detectLanguageFromRequest } from '../src/shared/detection';
+
+// A later English header must not override a supported query/cookie language.
+const requests = [
+  {
+    source: 'query',
+    url: '/?lng=zh-Hant-TW',
+    headers: { 'accept-language': 'en' },
+  },
+  {
+    source: 'cookie',
+    url: '/',
+    headers: { cookie: 'i18next=zh-Hant-TW', 'accept-language': 'en' },
+  },
+];
+
+test.each(requests)('$source falls back to a supported base language', req => {
+  expect(detectLanguageFromRequest(req, ['en', 'zh'])).toBe('zh');
+});
+
+test.each(requests)(
+  '$source prefers the full tag when both are supported',
+  req => {
+    expect(detectLanguageFromRequest(req, ['en', 'zh', 'zh-Hant-TW'])).toBe(
+      'zh-Hant-TW',
+    );
+  },
+);
+
+test('skips an unsupported query language and matches the cookie base language', () => {
+  expect(
+    detectLanguageFromRequest(
+      { url: '/?lng=fr-FR', headers: { cookie: 'i18next=zh-CN' } },
+      ['en', 'zh'],
+    ),
+  ).toBe('zh');
+});