112 lines
4.7 KiB
JavaScript
112 lines
4.7 KiB
JavaScript
// shared/friendly-fs-error.js —— 渲染端 + 主进程共用的 errno → 中文提示
|
||
//
|
||
// 覆盖 P0：Round 4 收尾前 renderer 端有三份独立 mapping（src/app.js /
|
||
// src/file-ops.js / main/file-ops.js），用户看到的 toast 文案 EROFS / ENAMETOOLONG
|
||
// / ENOTDIR / ENOTEMPTY 不一致。本测试钉死 shared 模块的 mapping 文案，main /
|
||
// preload / renderer 三处全依赖此单一事实源。每条 case 必须有断言 —— 防止未来
|
||
// 重构时改坏 mapping（用户会看到误导的"未知错误"）。
|
||
//
|
||
// shared/friendly-fs-error.js 是 CJS（module.exports = { friendlyFsError }），
|
||
// ESM 解析器不支持 named import from CJS —— vitest 在 node 环境下走 require 链路。
|
||
|
||
import { describe, it, expect } from 'vitest';
|
||
const { friendlyFsError } = require('../../shared/friendly-fs-error.js');
|
||
|
||
describe('friendlyFsError —— 已知 errno 映射', () => {
|
||
it('EACCES → 权限 / 占用提示', () => {
|
||
expect(friendlyFsError('EACCES')).toMatch(/占用|权限/);
|
||
});
|
||
|
||
it('EPERM → 权限 / 占用提示（与 EACCES 共用文案）', () => {
|
||
expect(friendlyFsError('EPERM')).toBe(friendlyFsError('EACCES'));
|
||
});
|
||
|
||
it('ENOSPC → 磁盘空间不足', () => {
|
||
expect(friendlyFsError('ENOSPC')).toBe('磁盘空间不足');
|
||
});
|
||
|
||
it('EROFS → 只读文件系统', () => {
|
||
expect(friendlyFsError('EROFS')).toBe('只读文件系统，无法写入');
|
||
});
|
||
|
||
it('EIO → 磁盘 I/O 错误', () => {
|
||
expect(friendlyFsError('EIO')).toBe('磁盘 I/O 错误');
|
||
});
|
||
|
||
it('EBUSY → 文件被其他程序占用', () => {
|
||
expect(friendlyFsError('EBUSY')).toBe('文件被其他程序占用');
|
||
});
|
||
|
||
it('ENAMETOOLONG → 路径过长', () => {
|
||
expect(friendlyFsError('ENAMETOOLONG')).toBe('路径过长');
|
||
});
|
||
|
||
it('ENOTDIR → 父目录不是目录', () => {
|
||
expect(friendlyFsError('ENOTDIR')).toBe('父目录不是目录');
|
||
});
|
||
|
||
it('EISDIR → 目标路径是文件夹', () => {
|
||
expect(friendlyFsError('EISDIR')).toBe('目标路径是文件夹，无法写入');
|
||
});
|
||
|
||
it('ENOTEMPTY → 目标文件夹不为空', () => {
|
||
expect(friendlyFsError('ENOTEMPTY')).toBe('目标文件夹不为空');
|
||
});
|
||
});
|
||
|
||
describe('friendlyFsError —— fallback 行为', () => {
|
||
it('未知 errno + 有 fallback → 返回 fallback', () => {
|
||
expect(friendlyFsError('EEXIST', '文件已存在')).toBe('文件已存在');
|
||
});
|
||
|
||
it('未知 errno + 无 fallback → 返回「未知错误」', () => {
|
||
expect(friendlyFsError('EEXIST')).toBe('未知错误');
|
||
});
|
||
|
||
it('未知 errno + fallback=空串 → 走 fallback（空串本身）', () => {
|
||
// 注意：空串是合法 fallback —— caller 故意传空串时不应被「未知错误」盖掉。
|
||
// 但代码实现是 `fallback || '未知错误'`，所以空串会被替换为「未知错误」。
|
||
// 这是有意的（避免空 toast），但要把行为钉死。
|
||
expect(friendlyFsError('EEXIST', '')).toBe('未知错误');
|
||
});
|
||
|
||
it('undefined code → 走 default', () => {
|
||
expect(friendlyFsError(undefined, 'fallback')).toBe('fallback');
|
||
});
|
||
|
||
it('null code → 走 default', () => {
|
||
expect(friendlyFsError(null, 'fallback')).toBe('fallback');
|
||
});
|
||
|
||
it('空字符串 code → 走 default', () => {
|
||
expect(friendlyFsError('', 'fallback')).toBe('fallback');
|
||
});
|
||
});
|
||
|
||
describe('friendlyFsError —— 业务码（K1-R4 audit 合约）', () => {
|
||
// audit fix (K1-R4)：所有 file:* / shell:* IPC 错误返回都有 code 字段。
|
||
// 业务码（PATH_NOT_ALLOWED / SYMLINK_NOT_ALLOWED / FILE_TOO_LARGE 等）不在
|
||
// errno 白名单里，renderer 一律走 fallback；而 renderer 8 个调用点现在传
|
||
// result.message（中文）而不是 result.error（业务码字符串）做 fallback，
|
||
// 这样业务码错误也能给用户友好提示。
|
||
it('PATH_NOT_ALLOWED → 走 fallback（中文化 message）', () => {
|
||
expect(friendlyFsError('PATH_NOT_ALLOWED', '路径不在数据目录内')).toBe('路径不在数据目录内');
|
||
});
|
||
|
||
it('SYMLINK_NOT_ALLOWED → 走 fallback', () => {
|
||
expect(friendlyFsError('SYMLINK_NOT_ALLOWED', '不允许在符号链接目录下创建文件')).toBe('不允许在符号链接目录下创建文件');
|
||
});
|
||
|
||
it('FILE_TOO_LARGE → 走 fallback', () => {
|
||
expect(friendlyFsError('FILE_TOO_LARGE', '文件超过 50 MB 上限')).toBe('文件超过 50 MB 上限');
|
||
});
|
||
|
||
it('FILE_CHANGED_EXTERNALLY → 走 fallback', () => {
|
||
expect(friendlyFsError('FILE_CHANGED_EXTERNALLY', '文件在外部被修改')).toBe('文件在外部被修改');
|
||
});
|
||
|
||
it('NOT_A_FILE → 走 fallback', () => {
|
||
expect(friendlyFsError('NOT_A_FILE', '该路径是文件夹')).toBe('该路径是文件夹');
|
||
});
|
||
});
|