TypeScript严格模式下移除对象空可选属性的类型错误解决

原代码问题分析 #

1. 泛型定义无效：T extends unknown ? any : any等价于直接使用any，完全丢失了TypeScript的类型检查能力，这也是索引报错的核心原因之一。
2. 判断条件逻辑错误：obj[prop] === Array.isArray是将属性值与数组判断函数做全等比较，逻辑完全错误，且不符合你"移除undefined、null、空字符串"的需求。
3. 索引类型不匹配：Object.keys()返回string[]，而泛型T没有明确的索引签名，导致赋值时TS无法确认prop是T的合法键。

符合Strict模式的解决方案 #

基础版（返回Partial类型）

这个版本保证类型安全，同时满足核心需求：

export function removeEmptyOptionalProperties<T extends Record<string, unknown>>(obj: T): Partial<T> {
  const result: Partial<T> = {};
  
  // 将Object.keys的结果断言为T的键数组，确保类型匹配
  (Object.keys(obj) as Array<keyof T>).forEach(prop => {
    const value = obj[prop];
    // 仅排除undefined、null、空字符串，保留false、0、数组（包括空数组）
    if (value !== undefined && value !== null && value !== '') {
      result[prop] = value;
    }
  });
  
  return result;
}

进阶版（返回精确的非空属性类型）

如果需要返回类型精确对应保留的属性（而非Partial<T>），可以用条件类型过滤：

// 过滤出需要保留的属性键
type NonEmptyPropertyKeys<T> = {
  [K in keyof T]: T[K] extends undefined | null | '' ? never : K;
}[keyof T];

// 从原类型中挑选保留的属性
type CleanedObject<T> = Pick<T, NonEmptyPropertyKeys<T>>;

export function removeEmptyOptionalProperties<T extends Record<string, unknown>>(obj: T): CleanedObject<T> {
  const result = {} as CleanedObject<T>;
  
  (Object.keys(obj) as Array<keyof T>).forEach(prop => {
    const value = obj[prop];
    if (value !== undefined && value !== null && value !== '') {
      result[prop as keyof CleanedObject<T>] = value as CleanedObject<T>[typeof prop];
    }
  });
  
  return result;
}

测试验证 #

用你的测试对象调用函数后，会正确移除undefinedProp、nullProp、emptyString，保留其余属性，且在Strict模式下无类型错误。调用示例：

const testObject = {
  undefinedProp: undefined,
  nullProp: null,
  falseProp: false,
  zeroProp: 0,
  emptyString: '',
  filledString: 'filledString',
  filledObject: { filledString: 'filledString' },
  filledArray: [{ filledString: 'filledString' }],
};

// 基础版返回Partial<typeof testObject>，进阶版返回精确的清理后类型
const result = removeEmptyOptionalProperties(testObject);
console.log('result:', result);

内容的提问来源于stack exchange，提问作者Michael R