update

tests/unit/friendly-fs-error.test.js

@@ -0,0 +1,111 @@
+// 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('该路径是文件夹');
+  });
+});