Files
SnapOtter/tests/e2e/i18n.spec.ts
T
SnapOtter d38621d7b9 feat: add multi-language support for 20 locales
Add complete i18n infrastructure with 21 supported languages:
English, Simplified Chinese, Traditional Chinese, Japanese, Korean,
Spanish, French, Italian, Brazilian Portuguese, German, Dutch, Swedish,
Russian, Polish, Ukrainian, Arabic (RTL), Turkish, Hindi, Vietnamese,
Indonesian, and Thai.

- I18nProvider context with three-tier locale detection
  (user preference > navigator.languages > instance default > English)
- ~1500 translation keys per locale with TypeScript-enforced completeness
- Dynamic code-splitting: only the active locale is loaded at runtime
- Language selectors in footer, login page, settings, and mobile sidebar
- Arabic RTL support with CSS logical properties across all components
- Tool names, descriptions, and categories translated via i18n helpers
- Public API endpoint GET /api/v1/config/locale for instance default
- Multi-script font stack (CJK, Arabic, Devanagari, Thai, Cyrillic)
- format() and plural() helpers for interpolation and pluralization
- API error translation mapping (translateApiError)
- 36 Playwright e2e tests verifying all 21 locales load correctly
- 25 unit tests for format, plural, locale detection, and completeness
- Updated translations.md docs and CLAUDE.md conventions
2026-05-15 17:02:49 +08:00

214 lines
8.0 KiB
TypeScript

import { expect, test } from "@playwright/test";
const API = process.env.API_URL || "http://localhost:13490";
const LOCALES = [
{ code: "en", native: "English", dir: "ltr", sample: "Upload from computer" },
{ code: "de", native: "Deutsch", dir: "ltr", sample: "Vom Computer hochladen" },
{ code: "fr", native: "Français", dir: "ltr", sample: "Importer depuis" },
{ code: "es", native: "Español", dir: "ltr", sample: "Subir desde" },
{ code: "ja", native: "日本語", dir: "ltr", sample: "アップロード" },
{ code: "ko", native: "한국어", dir: "ltr", sample: "업로드" },
{ code: "zh-CN", native: "简体中文", dir: "ltr", sample: "上传" },
{ code: "zh-TW", native: "繁體中文", dir: "ltr", sample: "上傳" },
{ code: "ru", native: "Русский", dir: "ltr", sample: "Загрузить" },
{ code: "ar", native: "العربية", dir: "rtl", sample: "رفع" },
{ code: "pt-BR", native: "Português (Brasil)", dir: "ltr", sample: "Enviar do computador" },
{ code: "it", native: "Italiano", dir: "ltr", sample: "Carica dal computer" },
{ code: "nl", native: "Nederlands", dir: "ltr", sample: "Upload van computer" },
{ code: "sv", native: "Svenska", dir: "ltr", sample: "Ladda upp" },
{ code: "pl", native: "Polski", dir: "ltr", sample: "Prześlij" },
{ code: "uk", native: "Українська", dir: "ltr", sample: "Завантажити" },
{ code: "tr", native: "Türkçe", dir: "ltr", sample: "Bilgisayardan" },
{ code: "hi", native: "हिन्दी", dir: "ltr", sample: "अपलोड" },
{ code: "vi", native: "Tiếng Việt", dir: "ltr", sample: "Tải lên" },
{ code: "id", native: "Bahasa Indonesia", dir: "ltr", sample: "Unggah" },
{ code: "th", native: "ไทย", dir: "ltr", sample: "อัปโหลด" },
];
test.describe("i18n - API", () => {
test("GET /api/v1/config/locale returns default locale without auth", async ({ request }) => {
const res = await request.get(`${API}/api/v1/config/locale`);
expect(res.ok()).toBe(true);
const data = await res.json();
expect(data.defaultLocale).toBe("en");
});
});
test.describe("i18n - locale detection", () => {
test("defaults to English when no preference is set", async ({ page }) => {
await page.goto("/");
const lang = await page.getAttribute("html", "lang");
expect(lang).toBe("en");
});
test("document.dir is set to ltr after mount", async ({ page }) => {
await page.goto("/");
await page.waitForTimeout(500);
const dir = await page.getAttribute("html", "dir");
expect(dir).toBe("ltr");
});
});
test.describe("i18n - footer language selector", () => {
test("footer shows Globe button with current language name", async ({ page }) => {
await page.goto("/");
const footer = page.locator("text=English").last();
await expect(footer).toBeVisible();
});
test("clicking Globe opens language dropdown with all 21 languages", async ({ page }) => {
await page.goto("/");
await page.locator("button", { hasText: "English" }).last().click();
await page.waitForTimeout(300);
const dropdown = page.locator("[class*='overflow-y-auto']").last();
await expect(dropdown).toBeVisible();
for (const locale of LOCALES) {
const option = dropdown.locator("button", { hasText: locale.native });
await expect(option).toBeVisible();
}
});
test("selecting a language updates the UI", async ({ page }) => {
await page.goto("/");
await page.locator("button", { hasText: "English" }).last().click();
await page.waitForTimeout(300);
await page.locator("button", { hasText: "Deutsch" }).click();
await page.waitForTimeout(500);
const lang = await page.getAttribute("html", "lang");
expect(lang).toBe("de");
});
});
test.describe("i18n - locale persistence", () => {
test("selected locale persists in localStorage", async ({ page }) => {
await page.goto("/");
await page.locator("button", { hasText: "English" }).last().click();
await page.waitForTimeout(300);
await page.locator("button", { hasText: "Français" }).click();
await page.waitForTimeout(500);
const stored = await page.evaluate(() => localStorage.getItem("snapotter-locale"));
expect(stored).toBe("fr");
});
test("locale persists across page refresh", async ({ page }) => {
await page.goto("/");
await page.locator("button", { hasText: "English" }).last().click();
await page.waitForTimeout(300);
await page.locator("button", { hasText: "Español" }).click();
await page.waitForTimeout(500);
await page.reload();
await page.waitForTimeout(1000);
const lang = await page.getAttribute("html", "lang");
expect(lang).toBe("es");
});
});
test.describe("i18n - Arabic RTL", () => {
test("switching to Arabic sets dir=rtl", async ({ page }) => {
await page.goto("/");
await page.locator("button", { hasText: "English" }).last().click();
await page.waitForTimeout(300);
await page.locator("button", { hasText: "العربية" }).click();
await page.waitForTimeout(500);
const dir = await page.getAttribute("html", "dir");
expect(dir).toBe("rtl");
const lang = await page.getAttribute("html", "lang");
expect(lang).toBe("ar");
});
});
test.describe("i18n - login page", () => {
test("login page has language selector", async ({ page }) => {
await page.goto("/login");
const langSelector = page.locator("button", { hasText: "English" }).first();
await expect(langSelector).toBeVisible();
});
test("switching language on login page translates form labels", async ({ page }) => {
await page.goto("/login");
await page.locator("button", { hasText: "English" }).first().click();
await page.waitForTimeout(300);
await page.locator("button", { hasText: "Deutsch" }).click();
await page.waitForTimeout(500);
const loginHeading = page.locator("h2").first();
await expect(loginHeading).toContainText("Anmelden");
});
});
test.describe("i18n - all locales load", () => {
for (const locale of LOCALES) {
test(`${locale.code} (${locale.native}) loads and shows translated content`, async ({
page,
}) => {
await page.goto("/");
await page.evaluate((code) => localStorage.setItem("snapotter-locale", code), locale.code);
await page.reload();
await page.waitForTimeout(1000);
const lang = await page.getAttribute("html", "lang");
expect(lang).toBe(locale.code);
const dir = await page.getAttribute("html", "dir");
expect(dir).toBe(locale.dir);
const body = await page.textContent("body");
expect(body).toContain(locale.sample);
});
}
});
test.describe("i18n - tool names translate", () => {
test("tool names and categories show in selected language", async ({ page }) => {
await page.goto("/");
await page.evaluate(() => localStorage.setItem("snapotter-locale", "de"));
await page.reload();
await page.waitForTimeout(1500);
const body = await page.textContent("body");
expect(body).toContain("Grundlagen");
expect(body).toContain("Komprimieren");
});
test("tool names show in Japanese", async ({ page }) => {
await page.goto("/");
await page.evaluate(() => localStorage.setItem("snapotter-locale", "ja"));
await page.reload();
await page.waitForTimeout(1500);
const body = await page.textContent("body");
expect(body).toContain("リサイズ");
});
});
test.describe("i18n - switching back to English", () => {
test("can switch back to English after using another language", async ({ page }) => {
await page.goto("/");
await page.evaluate(() => localStorage.setItem("snapotter-locale", "de"));
await page.reload();
await page.waitForTimeout(1000);
let lang = await page.getAttribute("html", "lang");
expect(lang).toBe("de");
await page.evaluate(() => localStorage.setItem("snapotter-locale", "en"));
await page.reload();
await page.waitForTimeout(1000);
lang = await page.getAttribute("html", "lang");
expect(lang).toBe("en");
const body = await page.textContent("body");
expect(body).toContain("Upload from computer");
});
});