Tema 5 · Objetos Tipados

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 ser undefined. Por ejemplo telefono?: string equivale a string | 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.

objetosTipados.ts
Solo lectura
// 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']}`);
Pruébalo tú mismo » Se abre en una nueva pestaña con ejecución en vivo
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.