Artículo de demostración: las recomendaciones son generales y pueden adaptarse a tu experiencia.
TypeScript no elimina los errores, pero puede obligarnos a pensar mejor dónde están los límites de nuestros datos.
Validar en los bordes
Los datos que llegan desde una API o un formulario no son fiables solo porque los tipemos como User. Valido su forma antes de utilizarlos en el resto de la aplicación.
type User = { id: string; name: string };
function isUser(value: unknown): value is User {
if (typeof value !== 'object' || value === null) return false;
const record = value as Record<string, unknown>;
return typeof record.id === 'string' && typeof record.name === 'string';
}Tipar el resultado, no solo los parámetros
Los tipos de retorno explícitos son especialmente útiles en funciones públicas. Funcionan como documentación viva y ayudan a detectar cambios accidentales.
Preferir nombres que expliquen intención
Un tipo llamado ArticleSummary comunica más que uno llamado Data. La claridad siempre gana tiempo a medio plazo.
Una idea para recordar
La mejor arquitectura es la que facilita los cambios reales del proyecto, no la que anticipa todas las posibilidades imaginables.