Files
cloudflare_temp_email/e2e/tests/browser/locale-switch.spec.ts
bhwa233 eb62c37e02 feat(i18n): enhance locale handling and routing (#996)
* feat(i18n): enhance locale handling and routing

- Implemented dynamic locale aliases in router configuration.
- Added support for preferred locale storage in global state.
- Improved locale resolution logic in router beforeEach guard.
- Created utility functions for locale management and path manipulation.
- Added tests for locale matching and message extraction.
- Updated Header component to allow language selection.
- Refactored getRouterPathWithLang to utilize new locale utilities.
- Updated Vite configuration to support aliasing for vue-i18n.
- Bumped version numbers across various packages to 1.9.0.

* feat(i18n): update version to 1.8.0 and enhance locale handling

- Updated version numbers across all package.json files to 1.8.0.
- Enhanced locale handling in App.vue by centralizing locale configurations.
- Improved Turnstile component to support dynamic language rendering.
- Refactored i18n utilities to include initial locale setup and empty locale messages.
- Updated i18n.ts to utilize the new locale management structure.
- Added naive-locale.ts for better integration with Naive UI's locale handling.
- Adjusted Header.vue to streamline language selection and locale changes.
- Fixed translations in multiple locale files for consistency and accuracy.

* fix(i18n): address review feedback

* feat(i18n): update default locale to English and enhance language handling in components

* fix(i18n): switch locale selector to dropdown

* docs: add topbar language and github order design spec

* fix(i18n): 修复 Header 语言切换器相关问题,恢复为独立控件并调整样式

* Refactor locale handling in router and add locale-guard utility functions

- Improved locale resolution logic in router by introducing utility functions for better readability and maintainability.
- Added `locale-guard.js` to encapsulate locale-related functions such as getting route locale, resolving locale for navigation, and applying locale navigation state.
- Updated JWT synchronization logic to streamline the handling of JWT from query parameters.
- Modified i18n messages test to check for coverage of registered locale message keys instead of extracting English source messages.

* 删除顶部栏语言和GitHub顺序设计文档

* fix: 修复前端设置初始化时未返回 domains 数组导致的 undefined 错误

* refactor(i18n): consolidate locale infrastructure

* fix(i18n): stabilize locale route switching

* fix(i18n): persist default locale selection

* fix(i18n): 修复前端设置初始化时未返回 domains 数组导致的 undefined 错误,统一按空数组兜底处理
feat(i18n): 添加 locale 别名处理,支持默认语言的重定向
test(i18n): 增加对默认语言别名重定向的测试用例

* refactor: replace useAppI18n with useScopedI18n in multiple components for improved localization management

* fix(tests): 移除不必要的 URL 断言以简化 Passkey 测试

* fix(i18n): 更新语言切换逻辑,确保使用当前语言设置进行路由导航

* fix(i18n): 强制路由切换以确保语言切换后正确导航

* refactor(i18n): 优化消息注册和路由本地化逻辑,移除冗余代码

* refactor(i18n): 拆分 API 文件以优化路由管理,更新语言处理逻辑

* fix: align i18n release notes and frontend test script
2026-04-25 13:46:26 +08:00

65 lines
2.7 KiB
TypeScript

import { expect, test } from '@playwright/test';
import type { Locator, Page } from '@playwright/test';
import { FRONTEND_URL } from '../../fixtures/test-helpers';
const installLocaleInitScript = async (page: Page, locales: string[], preferredLocale: string | null = null) => {
await page.addInitScript(
({ locales: initialLocales, preferredLocale: initialPreferredLocale }: { locales: string[]; preferredLocale: string | null }) => {
const localeInitStorageKey = '__localeInitDone';
if (!window.sessionStorage.getItem(localeInitStorageKey)) {
window.localStorage.removeItem('preferredLocale');
if (initialPreferredLocale) {
window.localStorage.setItem('preferredLocale', initialPreferredLocale);
}
window.sessionStorage.setItem(localeInitStorageKey, '1');
}
Object.defineProperty(window.navigator, 'language', {
configurable: true,
get: () => initialLocales[0],
});
Object.defineProperty(window.navigator, 'languages', {
configurable: true,
get: () => initialLocales,
});
},
{ locales, preferredLocale },
);
};
const selectLanguage = async (page: Page, selectTrigger: Locator, optionLabel: string) => {
await selectTrigger.click();
const option = page.locator('.n-dropdown-option, .n-dropdown-option-body').filter({ hasText: optionLabel }).first();
await expect(option).toBeVisible();
await option.click();
};
test.describe('Locale switching', () => {
test('keeps default route in Chinese while persisting browser language preference', async ({ page }) => {
await installLocaleInitScript(page, ['es-ES', 'en-US']);
await page.goto(`${FRONTEND_URL}/`);
await expect(page).toHaveURL(`${FRONTEND_URL}/`);
await expect.poll(() => page.evaluate(() => window.localStorage.getItem('preferredLocale'))).toBe('es');
await expect.poll(() => page.evaluate(() => document.documentElement.lang)).toBe('zh');
});
test('mobile drawer switch updates locale route and persisted preference', async ({ page }) => {
await page.setViewportSize({ width: 375, height: 844 });
await installLocaleInitScript(page, ['zh-CN']);
await page.goto(`${FRONTEND_URL}/`);
await page.getByRole('button', { name: /菜单|Menu/i }).click();
const drawerLocaleDropdown = page.locator('.n-drawer').getByRole('button', { name: /中文|English|Español|Português|日本語|Deutsch/ }).first();
await selectLanguage(page, drawerLocaleDropdown, 'Deutsch');
await expect(page).toHaveURL(`${FRONTEND_URL}/de/`);
await expect.poll(() => page.evaluate(() => window.localStorage.getItem('preferredLocale'))).toBe('de');
await expect.poll(() => page.evaluate(() => document.documentElement.lang)).toBe('de');
});
});