Tipos de datos en TypeScript: la referencia completa
Tipos de datos en TypeScript
Tipos de datos en TypeScript: todos en una tabla con buscador | We.Inc
string, number, boolean, bigint, symbol, null, undefined, any, unknown, never, void, object, arrays, tuplas, enums, tipos literales y uniones, con un ejemplo de cada uno.
Los tipos de datos básicos de TypeScript son los siete primitivos de JavaScript, string, number, bigint, boolean, symbol, null y undefined, escritos en minúsculas. Sobre ellos añade tipos especiales (any, unknown, never, void, object), estructuras como arrays, tuplas y enums, y formas de combinar tipos: tipos literales, uniones e intersecciones.
Los cuatro grupos
- Grupo
- Tipos
- Para qué sirve
- Primitivos
- string, number, bigint, boolean, symbol, null, undefined
- Valores individuales
- Especiales
- any, unknown, never, void, object
- Describir los extremos del sistema de tipos
- Estructuras
- Arrays, tuplas, enums, tipos de objeto
- Grupos de valores
- Combinaciones
- Tipos literales, uniones, intersecciones
- Formas precisas o flexibles
Busca en la referencia por nombre o fíltrala por grupo. Cada fila tiene un ejemplo de una línea que puedes pegar en un archivo .ts, y la columna de notas señala el comportamiento que confunde a la gente, como la diferencia entre void y undefined o por qué unknown es más seguro que any.
- Escribe en el buscador para encontrar un nombre de tipo, un ejemplo o una nota.
- Usa los botones de grupo para mostrar solo primitivos, tipos especiales, estructuras o combinaciones.
- Lee el ejemplo y la nota de cada fila; el contador sobre la tabla indica cuántas filas coinciden.
- Sigue las guías relacionadas sobre enums, interfaces y Record cuando una fila necesite más detalle.
- Escribe string, number y boolean en minúsculas. String, Number y Boolean con mayúscula son tipos de objeto envoltorio y casi nunca son lo que quieres.
- Tipa como unknown los valores que vienen de fuera de tu código, como JSON y datos de formularios, y luego acótalos. any desactiva el verificador en todo lo que toca.
- Deja que la inferencia haga el trabajo en las variables locales. Anota los parámetros de funciones, los tipos de retorno de las funciones exportadas y los arrays o Maps vacíos.
- Añade una rama default que asigne a never en un switch sobre una unión. El día que alguien añada un miembro, la compilación señalará cada switch que lo olvidó.
Preguntas frecuentes
¿Cuántos tipos primitivos tiene TypeScript?
Siete, los mismos que JavaScript: string, number, bigint, boolean, symbol, null y undefined. number cubre tanto enteros como decimales; no existe un tipo int o float aparte.
¿Qué diferencia hay entre any y unknown?
Ambos aceptan cualquier valor. any te deja hacer cualquier cosa con él, así que los errores pasan sin avisar. unknown no te deja hacer nada hasta que lo acotas con una comprobación como typeof, lo que lo convierte en la opción segura para datos no confiables.
¿Para qué sirve el tipo never?
never describe valores que no pueden darse: el tipo de retorno de una función que siempre lanza un error, y lo que queda de una unión después de tratar todos sus miembros. Ese segundo uso hace posibles las comprobaciones de exhaustividad.
¿void es lo mismo que undefined?
No. void es el tipo de retorno de una función cuyo valor devuelto debe ignorarse. A una función tipada como que devuelve void se le puede pasar un callback que devuelva algo, mientras que undefined significa que el valor es realmente undefined.
¿Qué diferencia hay entre object, Object y {}?
object significa cualquier valor no primitivo, como objetos, arrays y funciones. {} significa cualquier valor excepto null y undefined, primitivos incluidos. El tipo global Object rara vez es útil; prefiere object o un tipo de objeto concreto.
Primitivos: lo que indica typeof
- Los tipos primitivos en minúsculas coinciden con lo que el operador typeof de JavaScript indica en tiempo de ejecución, y por eso las comprobaciones con typeof los acotan tan limpiamente. null es la excepción: typeof null es "object", así que compruébalo con === null.
- bigint necesita un objetivo de compilación ES2020 o posterior para la sintaxis literal 123n. Los valores symbol son únicos incluso cuando se crean con la misma descripción.
Los tipos especiales marcan los extremos
- any y unknown están arriba del todo: cualquier valor cabe en ellos. never está abajo del todo: ningún valor cabe, y él cabe en cualquier otro tipo. void trata de los valores de retorno, y object sirve para descartar los primitivos.
- Saber en qué extremo estás hace legibles los mensajes del compilador. Un error que menciona never tras acotar suele indicar una rama que el código cree que nunca puede ejecutarse.
Combinar tipos
- Un tipo literal reduce un primitivo a valores exactos, como "left" | "right". Una unión dice que un valor es uno de varios tipos; una intersección dice que es todos a la vez, que es como se fusionan dos tipos de objeto.
- Las uniones de literales de cadena suelen sustituir a los enums, porque se eliminan por completo al compilar y se leen con naturalidad en el código. La guía de enums de este sitio compara ambas opciones.
De unknown a un tipo utilizable
Acota una entrada no confiable paso a paso
Cada comprobación elimina posibilidades. Dentro de la última rama el compilador sabe que value es un string.
never como comprobación de exhaustividad
Si un nuevo estado se une a la unión, la asignación a never deja de compilar hasta que se añada un case para él.
Texto de cualquier longitud. Las plantillas literales también son strings.
Enteros y decimales por igual, incluidos NaN e Infinity.
Números enteros más allá del rango de enteros seguros. El sufijo n necesita un objetivo ES2020.
Solo true o false.
Cada invocación de Symbol() crea un valor único.
Con strictNullChecks activado, null debe figurar en el tipo para estar permitido.
El valor de una variable declarada pero sin asignar y de una propiedad opcional ausente.
Desactiva la comprobación para el valor. noImplicitAny señala los sitios donde se cuela sin avisar.
Admite cualquier valor pero no permite nada hasta que lo acotas.
Ningún valor tiene nunca este tipo: funciones que siempre lanzan errores y uniones a las que no les queda nada.
Un valor de retorno que debe ignorarse. No es lo mismo que undefined.
Cualquier no primitivo: objetos, arrays y funciones.
Array
string[] y Array<string> significan lo mismo.
Array de solo lectura
Equivale a ReadonlyArray<number>. Se eliminan push y los demás métodos que mutan.
Tupla
Longitud fija con un tipo por posición. Los elementos opcionales van al final: [number, number?].
Genera un objeto real en tiempo de ejecución, a diferencia de casi toda la sintaxis de TypeScript.
Tipo de objeto
Describe las propiedades en línea. Ponle nombre con type o interface para reutilizarlo.
Tipo de función
Tipos de parámetros y de retorno. Prefiérelo al tipo genérico Function.
Tipo literal
Valores exactos en lugar del primitivo completo.
Unión
Uno de varios tipos. Acota con typeof, in o un campo compartido antes de usar sus miembros.
Intersección
Todos los tipos a la vez. Se usa sobre todo para fusionar tipos de objeto.
Primitivos
Especiales
Estructuras
Combinaciones
Referencia de tipos con buscador
Buscar tipos
unknown, tupla, null...
Filtrar por grupo
Todos
Mostrando {n} de {v} tipos
Ningún tipo coincide con esa búsqueda.
Tipos de TypeScript con ejemplos
Tipo
Grupo
Ejemplo
Nota
Empieza la prueba gratis · Prueba gratis de 7 días, $0 hoy
Relacionado: Guías
- Enums de TypeScript y sus alternativas
- Interfaces en TypeScript
- Bucles en TypeScript y los tipos que te dan
- Map en TypeScript
- El tipo Record de TypeScript, explicado con tus claves
- TypeScript vs JavaScript
- Gobernanza web universitaria
- Diagramas de flujo de usuario y wireframes web en SVG
Producto
Para quién es
- Para agencias
- Para freelancers
- Para proveedores de hosting
- Para plataformas SaaS
- Para startups
- Servicios financieros
- Soluciones para salud
Funciones
Recursos
- Blog
- Centro de Ayuda
- Herramientas gratuitas para empresas
- Free UI Components
- Plantillas
- Colecciones de plantillas
- Ejemplos de webs
- Guías
- Comparativas
- Alternativas
- Los mejores
- Reseñas
- Guías de precios
- Casos de uso
- Glosario y guías
- Integraciones
- Desarrolladores
- Benchmark
- Windows App