Sanyanggae LogoSanyanggae

📱 Des. Móvil

Tipos condicionales de TypeScript e infer: transformar tipos con pequeños ejemplos

Explora tipos condicionales, distribución de uniones y literales de plantilla, distinguiéndolos de la validación en ejecución.

사냥개 (Sanyanggae)Publicado Actualizado 9 min de lectura

Este artículo es una traducción del original en coreano. Original en coreano · Revisión de la traducción: Revisión con IA

Diagrama explicativo: Tipos condicionales · infer y distribución · Validación en ejecución. Tipos condicionales de TypeScript e infer: transformar tipos con pequeños ejemplos
SANYANGGAE · Diagrama explicativo · Tipos condicionales · infer y distribución · Validación en ejecución.

Repetir declaraciones similares en TypeScript invita a calcular el tipo de salida desde el de entrada. Importa más que la relación sea clara que ahorrar caracteres. Usaremos un servicio ficticio de avisos de entrega para estudiar tipos condicionales e infer, separándolos de comprobar si los datos externos son realmente válidos.

1. Un tipo condicional decide según un tipo de entrada

La documentación oficial explica cómo elegir el resultado mediante extends. El ejemplo produce un tipo literal booleano según la entrada sea de tipo cadena. No es una función que compruebe cadenas en ejecución.

type IsText<T> = T extends string ? true : false;
type NameIsText = IsText<'parcel'>; // true
type CountIsText = IsText<3>;       // false

Suponga que la función de avisos recibe identificadores de cadena y una función interna recibe números. Antes de usar tipos condicionales, explique por qué se distinguen. Nombres separados ayudan si significan cosas diferentes; si solo cambia la notación, unificar entradas puede resultar más legible. No oculte ambigüedades del diseño de datos con técnicas de tipos.

Escriba pares de entrada y salida esperadas. Ejemplos pequeños de cadenas, números, uniones y entradas inesperadas facilitan leer declaraciones complejas. Compruebe que los comentarios coinciden con la inferencia del editor. Un nombre natural no garantiza el resultado calculado.

2. Distribuir una unión cambia el sentido del array

Si el parámetro aparece directamente a la izquierda de la condición, esta se distribuye sobre cada miembro de la unión. Para tratar la unión entera como una sola, compare la versión envuelta en corchetes.

type SeparateLists<T> = T extends unknown ? T[] : never;
type Together<T> = [T] extends [unknown] ? T[] : never;
type A = SeparateLists<string | number>; // string[] | number[]
type B = Together<string | number>;      // (string | number)[]
const a: A = ['a', 'b'];
const b: B = ['a', 1];

El primer resultado es un array solo de cadenas o solo de números. El segundo admite ambos en un mismo array. La elección depende de si toda la lista de entregas debe llevar un único tipo de código o cada elemento puede variar. Ambos muestran corchetes, pero sus contratos son distintos.

Al depurar, introduzca un miembro cada vez en lugar de leer todo un utilitario complejo. Compare cadena, número y unión. Entender si la distribución era intencionada explica también los corchetes. Conserve ejemplos de valores permitidos, además del tipo final, en la revisión.

3. infer da nombre a un tipo dentro de una estructura

En tipos condicionales, infer nombra una parte de la estructura reconocida. Este pequeño tipo elimina un único nivel de Promise.

type OneResult<T> = T extends Promise<infer Value> ? Value : T;
type Parcel = OneResult<Promise<{ tracking: string }>>;
type ParcelList = OneResult<Promise<string[]>>;

El código no ejecuta ni espera trabajo asíncrono; expresa la forma del resultado al compilar. Un nombre de función como Resolved podría sugerir que ya llegó un valor, así que considere el contexto donde se usa el tipo. La espera real sigue correspondiendo al código asíncrono.

Si necesita resultados esperados recursivamente, revise el utilitario estándar Awaited antes de ampliar el ejemplo de un nivel. La sencillez didáctica difiere de los requisitos de una herramienta compartida. Documente las entradas con resultados distintos del estándar y por qué se necesitan esas diferencias al introducir un utilitario.

4. Formar eventos con literales de plantilla

Los tipos literales de plantilla representan combinaciones de cadenas literales. Nuestro servicio puede combinar ámbito y acción en nombres de evento.

type Scope = 'parcel' | 'address';
type Action = 'created' | 'updated';
type EventName = `${Scope}:${Action}`;
const event: EventName = 'parcel:created';

La compilación detecta erratas, pero que todas las combinaciones sean válidas en el servicio es otra cuestión. Si solo se admite el evento de eliminación de dirección, el simple producto de ámbitos y acciones puede expresar mal la regla. Considere primero relacionar explícitamente eventos permitidos y payload.

Al crecer los eventos, sus nombres reales deben seguir siendo fáciles de localizar. En vez de encadenar muchas reglas automáticas, se pueden reunir en un archivo los nombres enviados a sistemas externos. Compare cómo una persona nueva detectaría un evento incorrecto antes y después de abstraer. Evalúe sofisticación y uso conjuntamente.

5. El JSON externo exige comprobaciones en ejecución

Poner User o Parcel como tipo de una respuesta API no garantiza su estructura real. Veamos cómo recibir un valor externo como unknown y comprobar campos necesarios.

function hasTracking(value: unknown): value is { tracking: string } {
  return typeof value === 'object' && value !== null
    && 'tracking' in value && typeof value.tracking === 'string';
}
const incoming: unknown = { tracking: 'DEMO-001' };
if (hasTracking(incoming)) console.log(incoming.tracking);

Solo se comprueba que tracking sea cadena. No se confirma que el número exista ni que el usuario pueda ver esa entrega. Estrechamiento de tipos, reglas de negocio y autorización son responsabilidades distintas. La documentación oficial de narrowing explica cómo las condiciones afinan la información del tipo.

6. Un breve orden para elegir herramientas de tipos

Escriba dos valores reales permitidos y dos rechazados. Exprese después el significado con uniones normales y objetos explícitos. Use condicionales o infer cuando persistan relaciones repetidas, haciendo clara su razón. Si leer las declaraciones cuesta mucho más, extraiga solo lo común y conserve tipos ordinarios para el resto.

Ejecute por separado comprobación de tipos y validación en ejecución. Confirmar que el compilador rechaza un evento incorrecto complementa comprobar que el programa explica errores si el servidor omite campos. Verifique ejemplos pequeños y conéctelos con los límites de entrada reales para contribuir a una aplicación segura.

Fuentes y referencias

Este artículo explica información de fuentes públicas. Citar una institución no implica su revisión ni su aprobación.

Editor y contacto

Otros artículos sobre el tema