Biblioteca estándar de TypeScript: guía completa

Biblioteca Estándar de TypeScript: Visión General Completa

TypeScript es un superconjunto de JavaScript fuertemente tipado que añade tipificación estática y potentes herramientas para el desarrollo de aplicaciones grandes. A diferencia de muchos lenguajes, TypeScript no tiene una biblioteca estándar extensa incorporada en el sentido clásico (como, por ejemplo, Java o Python). En su lugar, proporciona un conjunto de tipos incorporados, utilidades para trabajar con tipos, decoradores e instrumentos del compilador. En este artículo, analizaremos en detalle todos los componentes clave de la biblioteca estándar de TypeScript.

1. Tipos de datos incorporados

TypeScript incluye todos los tipos primitivos de JavaScript y añade los suyos propios:

boolean — tipo lógico
number — números (enteros y de punto flotante)
string — cadenas de texto
null y undefined — valores especiales
symbol — identificadores únicos
bigint — números enteros grandes
any — desactivación de la verificación de tipos
unknown — alternativa segura a any
never — tipo para funciones que nunca terminan
void — ausencia de valor de retorno

Ejemplo de uso de tipos incorporados:

let isDone: boolean = false;let decimal: number = 42;let color: string = "azul";let notSure: unknown = 4;notSure = "ahora es una cadena"; // válido

function error(message: string): never {    throw new Error(message);}

2. Tipos Utilitarios (Utility Types)

TypeScript proporciona potentes utilidades incorporadas para la transformación de tipos. Estas son las más útiles:

Partial<T> — hace que todos los campos del tipo T sean opcionales
Required<T> — hace que todos los campos sean obligatorios
Readonly<T> — hace que todos los campos sean de solo lectura
Pick<T, K> — selecciona las claves especificadas del tipo
Omit<T, K> — excluye las claves especificadas
Record<K, T> — crea un tipo de objeto con claves K y valores T
Exclude<T, U> — excluye los tipos presentes en U
ReturnType<T> — extrae el tipo de valor de retorno de una función

Ejemplo de uso de tipos utilitarios:

interface User {    id: number;    name: string;    email: string;}

// Actualización parcial de usuariofunction updateUser(id: number, changes: Partial<User>): void {    // Lógica de actualización}

// Solo lecturaconst readonlyUser: Readonly<User> = {    id: 1,    name: "Iván",    email: "ivan@example.com"};

// Selección de campostype UserName = Pick<User, "name" | "email">;

3. Decoradores

Los decoradores son declaraciones especiales que permiten modificar clases, métodos, propiedades y parámetros. TypeScript admite varios tipos de decoradores:

Decoradores de clase — se aplican al constructor de la clase
Decoradores de método — se aplican a los métodos de la clase
Decoradores de propiedad — se aplican a las propiedades
Decoradores de parámetro — se aplican a los parámetros de los métodos

Ejemplo de decorador de método para registro (logging):

function log(target: any, propertyKey: string, descriptor: PropertyDescriptor) {    const originalMethod = descriptor.value;    descriptor.value = function (...args: any[]) {        console.log(`Llamada a ${propertyKey} con argumentos: ${JSON.stringify(args)}`);        return originalMethod.apply(th