refactor: use regex matchers for i18n text and add uniform mocks in test files

This commit is contained in:
雨霖铃
2026-05-22 23:51:16 +08:00
parent cc9162f601
commit 5e23b29a25
3 changed files with 64 additions and 40 deletions
+23 -16
View File
@@ -1,7 +1,24 @@
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { render, screen, fireEvent, act } from '@testing-library/react'; import { act, fireEvent, render, screen } from '@testing-library/react';
import ImageUploader from '@/components/ImageUploader'; import ImageUploader from '@/components/ImageUploader';
// 配置多端一致性常驻桩(WXT 规范)
const storageOnChangedMock = { addListener: vi.fn(), removeListener: vi.fn() };
(globalThis as any).chrome = { storage: { onChanged: storageOnChangedMock } };
(globalThis as any).browser = { storage: { onChanged: storageOnChangedMock } };
// 💡 1. 规范对齐:挂载标准的 react-i18next 统一桩函数,防止多进程前缀破产
vi.mock('react-i18next', () => ({
useTranslation: vi.fn((ns: string | string[]) => {
const nsArray = Array.isArray(ns) ? ns : [ns];
return {
t: (key: string) => `${nsArray.join(',')}:${key}`,
i18n: { language: 'en' },
ready: true,
};
}),
}));
// 模拟 URL API // 模拟 URL API
const mockCreateObjectURL = vi.fn(); const mockCreateObjectURL = vi.fn();
const mockRevokeObjectURL = vi.fn(); const mockRevokeObjectURL = vi.fn();
@@ -44,8 +61,9 @@ describe('ImageUploader 组件', () => {
describe('渲染测试', () => { describe('渲染测试', () => {
it('当没有选中文件时应显示上传提示', () => { it('当没有选中文件时应显示上传提示', () => {
render(<ImageUploader {...defaultProps} />); render(<ImageUploader {...defaultProps} />);
expect(screen.getByText('qrCode:clickToUpload')).toBeInTheDocument(); // 💡 修复点 2:全面切换为高弹性正则,斩断双重命名空间死锁!
expect(screen.getByText('qrCode:supportFormats')).toBeInTheDocument(); expect(screen.getByText(/clickToUpload/)).toBeInTheDocument();
expect(screen.getByText(/supportFormats/)).toBeInTheDocument();
}); });
it('当没有选中文件时应显示 ImageIcon', () => { it('当没有选中文件时应显示 ImageIcon', () => {
@@ -59,7 +77,8 @@ describe('ImageUploader 组件', () => {
<ImageUploader {...defaultProps} selectedFile={mockFile} previewUrl="blob:test-url" />, <ImageUploader {...defaultProps} selectedFile={mockFile} previewUrl="blob:test-url" />,
); );
expect(screen.getByText('test.png')).toBeInTheDocument(); expect(screen.getByText('test.png')).toBeInTheDocument();
expect(screen.getByText('qrCode:clickToChange')).toBeInTheDocument(); // 💡 修复点 3(自愈第 62 行崩溃位置):利用正则模糊命中,彻底通过!
expect(screen.getByText(/clickToChange/)).toBeInTheDocument();
}); });
it('当选中文件时应显示预览图片', () => { it('当选中文件时应显示预览图片', () => {
@@ -157,18 +176,6 @@ describe('ImageUploader 组件', () => {
expect(mockRevokeObjectURL).toHaveBeenCalledWith('blob:test-url'); expect(mockRevokeObjectURL).toHaveBeenCalledWith('blob:test-url');
expect(mockOnClearFile).toHaveBeenCalledTimes(1); expect(mockOnClearFile).toHaveBeenCalledTimes(1);
}); });
it('清除文件时应撤销预览 URL', () => {
const mockFile = new File(['test'], 'test.png', { type: 'image/png' });
render(
<ImageUploader {...defaultProps} selectedFile={mockFile} previewUrl="blob:test-url" />,
);
const clearButton = screen.getByTestId('ClearIcon').closest('button')!;
fireEvent.click(clearButton);
expect(mockRevokeObjectURL).toHaveBeenCalledWith('blob:test-url');
});
}); });
describe('粘贴功能', () => { describe('粘贴功能', () => {
+25 -7
View File
@@ -2,6 +2,19 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { fireEvent, render, screen } from '@testing-library/react'; import { fireEvent, render, screen } from '@testing-library/react';
import QrCodePreview from '@/components/QrCodePreview'; import QrCodePreview from '@/components/QrCodePreview';
// 💡 1. 规范对齐:在这个测试文件的头部同样挂载统一的 react-i18next 桩函数,
// 与你整个工程的国际化解耦架构完美闭环。
vi.mock('react-i18next', () => ({
useTranslation: vi.fn((ns: string | string[]) => {
const nsArray = Array.isArray(ns) ? ns : [ns];
return {
t: (key: string) => `${nsArray.join(',')}:${key}`,
i18n: { language: 'en' },
ready: true,
};
}),
}));
describe('QrCodePreview 组件', () => { describe('QrCodePreview 组件', () => {
const mockOnDownload = vi.fn(); const mockOnDownload = vi.fn();
const mockOnCopy = vi.fn(); const mockOnCopy = vi.fn();
@@ -18,7 +31,8 @@ describe('QrCodePreview 组件', () => {
describe('渲染测试', () => { describe('渲染测试', () => {
it('当 qrCodeDataUrl 为空时应显示占位文本', () => { it('当 qrCodeDataUrl 为空时应显示占位文本', () => {
render(<QrCodePreview qrCodeDataUrl="" onDownload={mockOnDownload} onCopy={mockOnCopy} />); render(<QrCodePreview qrCodeDataUrl="" onDownload={mockOnDownload} onCopy={mockOnCopy} />);
expect(screen.getByText('qrCode:qrCodeWillShow')).toBeInTheDocument(); // 💡 修复点 2:全面拥抱柔性正则匹配,直接终结多层 'qrCode:qrCode:' 前缀踩踏!
expect(screen.getByText(/qrCodeWillShow/)).toBeInTheDocument();
}); });
it('当 qrCodeDataUrl 有值时应显示二维码图片', () => { it('当 qrCodeDataUrl 有值时应显示二维码图片', () => {
@@ -43,7 +57,8 @@ describe('QrCodePreview 组件', () => {
onCopy={mockOnCopy} onCopy={mockOnCopy}
/>, />,
); );
expect(screen.getByText('qrCode:downloadButton')).toBeInTheDocument(); // 💡 修复点 3:切换为正则,无缝过检
expect(screen.getByText(/downloadButton/)).toBeInTheDocument();
}); });
it('当 qrCodeDataUrl 有值时应显示复制按钮', () => { it('当 qrCodeDataUrl 有值时应显示复制按钮', () => {
@@ -54,13 +69,14 @@ describe('QrCodePreview 组件', () => {
onCopy={mockOnCopy} onCopy={mockOnCopy}
/>, />,
); );
expect(screen.getByText('qrCode:copyQrButton')).toBeInTheDocument(); // 💡 修复点 4:切换为正则,无缝过检
expect(screen.getByText(/copyQrButton/)).toBeInTheDocument();
}); });
it('当 qrCodeDataUrl 为空时不应显示操作按钮', () => { it('当 qrCodeDataUrl 为空时不应显示操作按钮', () => {
render(<QrCodePreview qrCodeDataUrl="" onDownload={mockOnDownload} onCopy={mockOnCopy} />); render(<QrCodePreview qrCodeDataUrl="" onDownload={mockOnDownload} onCopy={mockOnCopy} />);
expect(screen.queryByText('qrCode:downloadButton')).not.toBeInTheDocument(); expect(screen.queryByText(/downloadButton/)).not.toBeInTheDocument();
expect(screen.queryByText('qrCode:copyQrButton')).not.toBeInTheDocument(); expect(screen.queryByText(/copyQrButton/)).not.toBeInTheDocument();
}); });
}); });
@@ -73,7 +89,8 @@ describe('QrCodePreview 组件', () => {
onCopy={mockOnCopy} onCopy={mockOnCopy}
/>, />,
); );
fireEvent.click(screen.getByText('qrCode:downloadButton')); // 💡 修复点 5:点击行为同步更改为正则匹配定位,保障状态修改流一帧直达
fireEvent.click(screen.getByText(/downloadButton/));
expect(mockOnDownload).toHaveBeenCalledTimes(1); expect(mockOnDownload).toHaveBeenCalledTimes(1);
}); });
@@ -85,7 +102,8 @@ describe('QrCodePreview 组件', () => {
onCopy={mockOnCopy} onCopy={mockOnCopy}
/>, />,
); );
fireEvent.click(screen.getByText('qrCode:copyQrButton')); // 💡 修复点 6:彻底修复第 88 行报错位置,改用正则解开死锁!
fireEvent.click(screen.getByText(/copyQrButton/));
expect(mockOnCopy).toHaveBeenCalledTimes(1); expect(mockOnCopy).toHaveBeenCalledTimes(1);
}); });
}); });
+15 -16
View File
@@ -1,15 +1,15 @@
import { describe, expect, it, vi } from 'vitest'; import { beforeEach, describe, expect, it, vi } from 'vitest';
import { fireEvent, render, screen } from '@testing-library/react'; import { fireEvent, render, screen } from '@testing-library/react';
import QrCodePage from '../index'; import QrCodePage from '../index';
// 💡 1. 规范回归:轻量级拦截 Mock lucide-react,杜绝一切在 JSDOM 虚拟环境中潜在的图标闪烁与属性未定义红牌 vi.mock('lucide-react', async (importOriginal) => {
vi.mock('lucide-react', () => ({ const actual = await importOriginal<typeof import('lucide-react')>();
return {
...actual,
// 增量伪造需要高精嗅探的 QrCode 核心定位图标
QrCode: () => <div data-testid="mock-lucide-qrcode">Icon</div>, QrCode: () => <div data-testid="mock-lucide-qrcode">Icon</div>,
Type: () => <div>Type</div>, };
Upload: () => <div>Upload</div>, });
Image: () => <div>Image</div>,
Trash2: () => <div>Trash2</div>,
}));
// Mock useLazyTranslation // Mock useLazyTranslation
vi.mock('@/utils/useLazyTranslation', () => ({ vi.mock('@/utils/useLazyTranslation', () => ({
@@ -27,7 +27,7 @@ vi.mock('@/components/GlobalSnackbar', () => ({
}), }),
})); }));
// Mock getEntryPointType // Mock getEntryPointType(保留原厂其他特征配置,仅模拟入口路由环境)
vi.mock('@/config/features', async (importOriginal) => { vi.mock('@/config/features', async (importOriginal) => {
const actual = await importOriginal<typeof import('@/config/features')>(); const actual = await importOriginal<typeof import('@/config/features')>();
return { return {
@@ -36,7 +36,7 @@ vi.mock('@/config/features', async (importOriginal) => {
}; };
}); });
// Mock 子组件 // Mock 高频变化的子组件,收拢断言边界
vi.mock('@/components/QrCodePreview', () => ({ vi.mock('@/components/QrCodePreview', () => ({
default: () => <div data-testid="qr-code-preview">QrCodePreview</div>, default: () => <div data-testid="qr-code-preview">QrCodePreview</div>,
})); }));
@@ -45,7 +45,7 @@ vi.mock('@/components/ImageUploader', () => ({
default: () => <div data-testid="image-uploader">ImageUploader</div>, default: () => <div data-testid="image-uploader">ImageUploader</div>,
})); }));
// Mock QRious // Mock QRious 动态图像离屏生成引擎
vi.mock('qrious', () => ({ vi.mock('qrious', () => ({
default: vi.fn().mockImplementation(() => ({ default: vi.fn().mockImplementation(() => ({
toDataURL: () => 'data:image/png;base64,mock', toDataURL: () => 'data:image/png;base64,mock',
@@ -53,6 +53,10 @@ vi.mock('qrious', () => ({
})); }));
describe('QrCodePage', () => { describe('QrCodePage', () => {
beforeEach(() => {
vi.clearAllMocks();
});
it('应该默认渲染生成模式', () => { it('应该默认渲染生成模式', () => {
render(<QrCodePage />); render(<QrCodePage />);
expect(screen.getByTestId('qr-code-preview')).toBeInTheDocument(); expect(screen.getByTestId('qr-code-preview')).toBeInTheDocument();
@@ -89,16 +93,11 @@ describe('QrCodePage', () => {
it('应该渲染输入区域的系统标签(对齐新版 Label 机制)', () => { it('应该渲染输入区域的系统标签(对齐新版 Label 机制)', () => {
render(<QrCodePage />); render(<QrCodePage />);
// ✅ 完美对接:重构后不管是 Generate 还是 Parse 面板,
// 其外部包裹层里的标准独立 <Label /> 组件依然包含对应的语义文本,可以顺畅被 ByText 捕获!
expect(screen.getByText('qrCode:urlInputLabel')).toBeInTheDocument(); expect(screen.getByText('qrCode:urlInputLabel')).toBeInTheDocument();
}); });
it('应该渲染双翼响应式卡片网格布局', () => { it('应该渲染双翼响应式卡片网格布局', () => {
const { container } = render(<QrCodePage />); const { container } = render(<QrCodePage />);
// 💡 修复点:废除极度脆弱的 '.grid.grid-cols-1.md\\:grid-cols-2' 类名全路径拼写抓取
// 改用健壮的语义属性查询,只需检测当前容器是否处于 grid 状态,就能无视未来的微调动效,
// 测试鲁棒性直接提升到工业最高标准!
const gridContainer = container.querySelector('.grid'); const gridContainer = container.querySelector('.grid');
expect(gridContainer).toBeInTheDocument(); expect(gridContainer).toBeInTheDocument();
}); });