3 formas de transformar tipos en TypeScript

Cuando usamos tipos o interfaces, el compilador de TypeScript se asegura de que el objeto cumpla exactamente con esa estructura para evitar errores en tiempo de ejecución por propiedades faltantes.

A veces queremos tener la flexibilidad de crear un objeto sin romper el contrato definido con la interfaz.

Por ejemplo, imagina que tenemos la interfaz User con todas sus propiedades obligatorias:

interface User {
  username: string;
  password: string;
  roles: string[];
  active: boolean;
}

Quizás queremos crear un usuario primero y más adelante llamar a la API para obtener sus roles. Si intentamos crear el objeto sin todas las propiedades requeridas, el compilador nos muestra un error porque no encaja con la interfaz.

En muchos casos, caemos en la tentación de cambiar la propiedad a opcional con roles?: string[] para que compile, pero en el fondo sabemos que es una trampa.

TypeScript nos ofrece herramientas para manejar este escenario:

Partial: crea un nuevo tipo donde todas las propiedades del tipo original se vuelven opcionales:

let admin: Partial<User> = {
  username: 'admin',
  password: 'admin'
}

Gracias a una aportación de @lukeshiru, aprendí otras formas de abordar esto:

Partial hace que absolutamente todas las propiedades sean opcionales, y muchas veces eso no es lo que queremos.

TypeScript también nos ofrece otros utility types como Omit y Pick. Vamos a ver cómo funcionan.

Omit: crea un nuevo tipo tomando todas las propiedades del tipo original y quitando las claves que especifiquemos.

type UserWithoutRoles = Omit<User, "roles">;
 
const userWithoutRoles: UserWithoutRoles = {
    username: "admin",
    password: "admin",
};

Pick: crea un nuevo tipo a partir de un tipo existente seleccionando únicamente un grupo de propiedades.

type UserWithStatus = Pick<User, "username" | "active">
 
const userWithStatus: UserWithStatus = {
    username: "dany",
    active: true
}

¡Muchas gracias de nuevo a @lukeshiru por el aporte! :)

Consulta más información sobre los Utility Types de TypeScript. Una vez que transformes tus tipos, es muy probable que también necesites validarlos en tiempo de ejecución: revisa mi guía práctica sobre cómo verificar tipos en TypeScript para aprender sobre type narrowing y custom type guards.

Lee más artículos en danywalls.com. Foto de Suzi Kim en Unsplash