update

tests/unit/main/utils/errno-code.test.ts

@@ -0,0 +1,72 @@
+// tests/unit/main/utils/errno-code.test.ts
+//
+// 守 errnoCode 的收窄契约(2026-10-20,r201):
+//
+//   unknown → string | undefined,判据是**own property** 且值是 string。
+//
+// 为什么是 helper 而不是 inline `(err as { code?: unknown }).code`:
+//   inline 让 code 保持 unknown,`code === 'ENOENT'` 在 number / Symbol / null
+//   上都严格不等 —— 运行时行为其实**等价**,但契约不显式;helper 把
+//   "不是 string 的 code 一律落 undefined"这条写成类型,读者不用再推。
+//
+// 本文件锁三条:
+//   1. own string code → 原样返回;
+//   2. 非 string code(number / null / undefined / Symbol / 对象)→ undefined;
+//   3. **原型链上的 code 不算** —— 契约写的是 own property,`Object.prototype`
+//      上挂一个 code 就让所有对象都"有 code"是经典事故。
+//
+// 同族:errPayloadStr → tests/unit/main/utils/error-payload-str.test.ts
+//       error.ts 全量 → tests/unit/utils/error.test.ts
+import { describe, expect, it } from 'vitest';
+
+import { errnoCode } from '../../../../src/main/utils/error';
+
+describe('errnoCode — own string code 收窄(r201)', () => {
+  it('own string code → 原样返回', () => {
+    expect(errnoCode({ code: 'ENOENT' })).toBe('ENOENT');
+    expect(errnoCode({ code: 'EACCES' })).toBe('EACCES');
+    expect(errnoCode({ code: '' })).toBe('');
+  });
+
+  it('own code 但不是 string → undefined', () => {
+    expect(errnoCode({ code: 42 })).toBeUndefined();
+    expect(errnoCode({ code: null })).toBeUndefined();
+    expect(errnoCode({ code: undefined })).toBeUndefined();
+    expect(errnoCode({ code: Symbol('E') })).toBeUndefined();
+    expect(errnoCode({ code: { nested: true } })).toBeUndefined();
+  });
+
+  it('没有 code 字段 → undefined', () => {
+    expect(errnoCode({})).toBeUndefined();
+    expect(errnoCode({ errno: -2 })).toBeUndefined();
+  });
+
+  it('原型链上的 code → undefined(own property 收紧)', () => {
+    // 契约写的是 own property。`Object.prototype.code` 一旦被挂上,
+    // 用 `'code' in err` 判据会让**每一个**对象都"有 code"。
+    const proto = { code: 'INHERITED' } as Record<string, unknown>;
+    const child = Object.create(proto) as Record<string, unknown>;
+    expect(errnoCode(child)).toBeUndefined();
+    expect(errnoCode(Object.create({}) as Record<string, unknown>)).toBeUndefined();
+  });
+
+  it('null-proto 对象上的 own code 仍能被读到(hasOwnProperty.call 兼容)', () => {
+    const np = Object.create(null) as Record<string, unknown>;
+    np.code = 'ENOENT';
+    expect(errnoCode(np)).toBe('ENOENT');
+  });
+
+  it('非对象(字符串 / 数字 / null / undefined / 布尔)→ undefined', () => {
+    expect(errnoCode('ENOENT')).toBeUndefined();
+    expect(errnoCode(42)).toBeUndefined();
+    expect(errnoCode(null)).toBeUndefined();
+    expect(errnoCode(undefined)).toBeUndefined();
+    expect(errnoCode(true)).toBeUndefined();
+  });
+
+  it('NodeJS.ErrnoException 形态(真实 fs 错误)→ code 原样', () => {
+    const e = new Error('ENOENT: no such file') as NodeJS.ErrnoException;
+    e.code = 'ENOENT';
+    expect(errnoCode(e)).toBe('ENOENT');
+  });
+});