TypeScript中忽略模型空值的强类型最佳实践方案

安全阿岳

2026-6-21

更简洁的TypeScript清理UserModel无效属性实现

我们先明确需求：

基于给定的UserModel接口，清理掉对象中值为null、空字符串''或undefined的属性
保持代码的强类型特性，最终返回值要符合UserModel类型（满足POST接口的参数要求）
不引入外部库

方案一：使用`Object.fromEntries` + 过滤（最简洁）

这种写法用一行核心逻辑完成清理，代码紧凑且可读性强：

export interface UserModel {
  username: string;
  password: string;
  email: string;
  address?: string; // 修正原接口拼写错误，并标记为可选属性，符合需求描述
  phoneNumber: string;
}

function cleanUserModel(user: UserModel): UserModel {
  return Object.fromEntries(
    Object.entries(user).filter(([_, value]) => value != null && value !== '')
  ) as UserModel;
}

说明：

Object.entries(user)将对象转换为键值对数组
过滤条件value != null同时排除null和undefined，再额外排除空字符串''
Object.fromEntries将过滤后的键值对数组转回对象
最后用类型断言as UserModel，确保返回值符合接口要求（只要传入的user初始符合UserModel，过滤后必然保留所有必填属性，断言是安全的）

方案二：使用`reduce`累积有效属性

如果偏好更函数式的遍历写法，可以用reduce来构建清理后的对象：

function cleanUserModel(user: UserModel): UserModel {
  return Object.keys(user).reduce((cleaned, key) => {
    const value = user[key as keyof UserModel];
    if (value != null && value !== '') {
      cleaned[key as keyof UserModel] = value;
    }
    return cleaned;
  }, {} as Partial<UserModel>) as UserModel;
}

说明：