El tipo 'string' no se puede asignar al tipo: cómo entender y corregir el error de TypeScript

«Type 'string' is not assignable to type» — ¿qué es y por qué estás aquí?

Si alguna vez has escrito en TypeScript, seguramente te has encontrado con el subrayado rojo en el editor de código y el mensaje:

Type 'string' is not assignable to type 'SomeType'.

Este error es un auténtico «saludo» del tipado estricto. Asusta a los principiantes, pero en realidad es el mejor amigo del desarrollador. En este artículo analizaremos por qué surge el error Type 'string' is not assignable to type, cómo corregirlo y qué enfoques existen para trabajar con literales de cadena, tipos unión y genéricos. El artículo está escrito para el sitio educativo pythonlib.ru, pero los ejemplos son completamente en TypeScript.

1. La raíz del problema: ¿por qué TypeScript se queja de las cadenas?

TypeScript es una extensión de JavaScript que añade tipado estático. Cuando escribes:

let role: 'admin' | 'user' = 'admin';\nrole = 'moderator'; // Error: Type '"moderator"' is not assignable to type '"admin" | "user"'\n

TypeScript entiende que la variable role solo puede tomar dos valores: 'admin' o 'user'. Cuando intentas asignar 'moderator', el compilador muestra un error. Pero, ¿por qué dice «Type 'string' is not assignable to type»?

El problema es que el literal de cadena 'moderator' tiene el tipo string, mientras que el tipo esperado es 'admin' | 'user'. TypeScript compara tipos, no valores. Ve: «Me estás dando una cadena normal, pero yo espero cadenas específicas». De ahí el mensaje.

1.1. Ejemplo sencillo para entender

Consideremos un caso básico:

type Status = 'active' | 'inactive';\n\nfunction updateStatus(status: Status) {\n  console.log(status);\n}\n\nconst myStatus = 'active';\nupdateStatus(myStatus); // OK\n\nconst anotherStatus = 'pending';\nupdateStatus(anotherStatus); // Error: Type 'string' is not assignable to type 'Status'\n

En el último caso, la variable anotherStatus se infiere como string, no como 'pending'. TypeScript no sabe que 'pending' es un literal. Solo ve el tipo string. Esto se puede corregir indicando explícitamente el tipo:

const anotherStatus: 'pending' = 'pending'; // Ahora funciona\n

2. Comparación de enfoques: cómo evitar o corregir el error

Existen varias formas de manejar el error Type 'string' is not assignable to type. Las compararemos en términos de simplicidad, seguridad y rendimiento.

2.1. Enfoque 1: as const — congelar el literal

La forma más elegante es usar as const. «Congela» el valor como un literal:

const myStatus = 'active' as const;\nupdateStatus(myStatus); // OK\n

Ventajas: simple, legible, seguro.
\nDesventajas: solo funciona con const, no con let.

2.2. Enfoque 2: Type Assertion (as) — conversión explícita

Puedes decirle a TypeScript: «Sé lo que hago»:

const someString: string = 'active';\nupdateStatus(someString as Status); // OK\n

Ventajas: solución rápida.
\nDesventajas: desactivas la verificación de tipos. Si pasas un valor incorrecto, el error solo aparecerá en tiempo de ejecución.

2.3. Enfoque 3: Type Guard (guardia de tipo)

Escribamos una función que verifique si una cadena es un estado válido:

function isStatus(value: string): value is Status {\n  return value === 'active' || value === 'inactive';\n}\n\nfunction safeUpdate(value: string) {\n  if (isStatus(value)) {\n    updateStatus(value); // TypeScript sabe que value es Status\n  } else {\n    throw new Error('Estado no válido');\n  }\n}\n