5. Modelado de Objetos: Propiedades Opcionales (?), Modificador readonly y Index Signatures
Define formas de objetos precisas, protege campos contra mutación accidental con readonly y maneja claves dinámicas mediante firmas de índice seguras.
Estructuras de Objetos Tipadas en TypeScript
En JavaScript los objetos son dinámicos y mutables por naturaleza, lo que a menudo desemboca en mutaciones accidentales o referencias a propiedades con nombres mal escritos. TypeScript provee modificadores de acceso como readonly, propiedades opcionales ? y firmas de índice para controlar con precisión matemática la forma de cada objeto.
1. Modificadores de Propiedad Esenciales
- Propiedad Opcional (
?): La propiedad puede existir o serundefined. Por ejemplotelefono?: stringequivale astring | undefined. - Modificador de Solo Lectura (
readonly): La propiedad puede asignarse únicamente durante la inicialización del objeto. Intentar reasignarla posteriormente (obj.id = 2) genera un error de compilación. - Firmas de Índice (Index Signatures): Cuando un objeto funciona como mapa o diccionario donde no conocemos todas las claves de antemano:
[clave: string]: number.
2. Comprobación Estricta de Literales de Objeto (Excess Property Checks)
Cuando asignas un objeto literal directamente a un tipo, TypeScript aplica una comprobación estricta de propiedades sobrantes: si envías una clave que no existe en la definición del contrato, marcará un error inmediato para prevenir que envíes información errónea por error tipográfico.
⚡ Modelado de Entidades con readonly, Opcionales y Firmas de Índice
Configuración de interfaces inmutables y diccionarios dinámicos.
// 1. Definición del contrato con modificadores de control
interface UsuarioConfig {
readonly id: number; // Inmutable: solo asignable al crearse
nombre: string;
email: string;
telefono?: string; // Opcional (string | undefined)
preferencias?: {
temaOscuro: boolean;
notificacionesEmail: boolean;
};
}
// 2. Creación e inmutabilidad garantizada
const usuario: UsuarioConfig = {
id: 1001,
nombre: 'Ana María Gómez',
email: '[email protected]',
preferencias: {
temaOscuro: true,
notificacionesEmail: false,
},
};
// usuario.id = 1002;
// ERROR TS2540: Cannot assign to 'id' because it is a read-only property.
// 3. Firma de Índice (Index Signature) para Diccionarios Dinámicos
interface CacheMetricas {
[endpoint: string]: number; // Cualquier clave string tendrá un valor numérico
}
const metricasPorEndpoint: CacheMetricas = {
'/api/v1/usuarios': 1420,
'/api/v1/productos': 8500,
'/api/v1/auth/login': 340,
};
// 4. Alternativa moderna a Index Signatures: Record<K, V>
type DiccionarioErrores = Record<number, string>;
const codigosHttp: DiccionarioErrores = {
200: 'OK',
400: 'Bad Request',
404: 'Not Found',
500: 'Internal Server Error',
};
console.log(`Usuario: ${usuario.nombre}, Peticiones usuarios: ${metricasPorEndpoint['/api/v1/usuarios']}`);
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué sucede si intentas reasignar el valor de una propiedad marcada con el modificador readonly en un objeto tipado de TypeScript?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar TypeScript Profesional: Tipado Estático & Arquitectura Frontend/Backend y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.