73 lines
3.1 KiB
TypeScript
73 lines
3.1 KiB
TypeScript
// 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');
|
|
});
|
|
});
|