import { describe, expect, test } from "vitest"; import i18next from "i18next"; import { __getServerGlobalI18nResourceLoadCountForTests, ensureServerGlobalI18n, getServerRequestI18nLanguage, getServerI18nResourcesSnapshot, runWithServerI18nLanguage, } from "./i18next.global.server"; import { requestScopedT } from "./request-scoped-t"; describe("server global i18next bootstrap", () => { test("initialises the global instance with preloaded resources", async () => { await ensureServerGlobalI18n(); await ensureServerGlobalI18n(); expect(i18next.isInitialized).toBe(true); expect(__getServerGlobalI18nResourceLoadCountForTests()).toBe(1); // The sidebar toggle label is the canonical string that previously rendered // empty during SSR (causing button-name a11y failures + hydration #418). expect(i18next.t("components.sidebar.toggle")).not.toBe(""); expect(i18next.t("components.sidebar.toggle")).not.toBe("components.sidebar.toggle"); }); test("reuses the same parsed resource snapshot for request-scoped instances", async () => { const first = await getServerI18nResourcesSnapshot(); const second = await getServerI18nResourcesSnapshot(); expect(second).toBe(first); expect(__getServerGlobalI18nResourceLoadCountForTests()).toBe(1); }); test("keeps overlapping English and German async work request-scoped", async () => { await ensureServerGlobalI18n(); const singletonLanguage = i18next.language; const key = "components.sidebar.toggle"; let releaseEnglish!: () => void; const englishCanFinish = new Promise((resolve) => { releaseEnglish = resolve; }); let markEnglishStarted!: () => void; const englishStarted = new Promise((resolve) => { markEnglishStarted = resolve; }); const englishRequest = runWithServerI18nLanguage("en", async () => { const beforeOverlap = requestScopedT(key); markEnglishStarted(); await englishCanFinish; await new Promise((resolve) => setTimeout(resolve, 0)); return { beforeOverlap, afterOverlap: requestScopedT(key), language: getServerRequestI18nLanguage(), }; }); await englishStarted; const germanRequest = runWithServerI18nLanguage("de", async () => { const beforeOverlap = requestScopedT(key); releaseEnglish(); await new Promise((resolve) => setTimeout(resolve, 0)); return { beforeOverlap, afterOverlap: requestScopedT(key), language: getServerRequestI18nLanguage(), }; }); const [english, german] = await Promise.all([englishRequest, germanRequest]); expect(english).toEqual({ beforeOverlap: "Toggle sidebar", afterOverlap: "Toggle sidebar", language: "en", }); expect(german).toEqual({ beforeOverlap: "Seitenleiste umschalten", afterOverlap: "Seitenleiste umschalten", language: "de", }); expect(getServerRequestI18nLanguage()).toBeUndefined(); expect(i18next.language).toBe(singletonLanguage); }); test("retains the request translator for streaming work created before the response resolves", async () => { let streamedTranslation!: Promise; await runWithServerI18nLanguage("de", () => { streamedTranslation = new Promise((resolve) => { setTimeout(() => resolve(requestScopedT("components.sidebar.toggle")), 0); }); return new Response(null, { status: 200 }); }); expect(await streamedTranslation).toBe("Seitenleiste umschalten"); }); });