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

Producto

Para quién es

Funciones

Recursos

Empresa

Mapa del sitio