Manejo de Bibliotecas y Dependencias en TypeScript

Al trabajar en un proyecto TypeScript, es común necesitar usar bibliotecas y paquetes externos. En esta sección, aprenderemos cómo manejar estas dependencias y cómo asegurarnos de que TypeScript las reconozca correctamente.

Instalación de Definiciones de Tipos

Muchas bibliotecas de JavaScript no incluyen definiciones de tipos. Para resolver esto, el proyecto DefinitelyTyped provee definiciones de tipos que se pueden instalar a través de npm usando el prefijo @types.

Ejemplo con lodash

Supongamos que necesitas usar la biblioteca lodash en tu proyecto TypeScript.

1. Instala la biblioteca lodash y su definición de tipos correspondiente:

sh

2. Ahora puedes importar y usar lodash con seguridad de tipos:

ts

Bibliotecas sin Definiciones de Tipos

Si una biblioteca no tiene definiciones de tipos disponibles, puedes crear tus propias definiciones o utilizar declare para añadir tipos básicos.

Ejemplo con una biblioteca ficticia

Supongamos que estamos usando una biblioteca llamada fancy-library, que no tiene definiciones de tipos.

1. Instala la biblioteca:

sh

2. Crea un archivo de definición de tipos para la biblioteca llamada fancy-library.d.ts en un directorio @types:

ts

3. Ahora puedes importar y usar fancy-library en tu código TypeScript:

ts

Uso de CommonJS y ES6 Módulos

TypeScript permite utilizar tanto módulos CommonJS como ES6. Asegúrate de ajustar tu tsconfig.json para que el sistema de módulos sea compatible con el entorno en el que estás trabajando.

Configuración para Node.js (CommonJS)

json

Configuración para Navegadores (ES6 Modules)

json

Tipos Ambientales

TypeScript permite declarar tipos ambientales para bibliotecas globales o cualquier otro tipo que desees declarar a nivel global. Esto se hace comúnmente en archivos d.ts.

Ejemplo de Declaraciones Globales

Crea un archivo globals.d.ts:

ts

Ahora puedes usar myGlobalFunction en cualquier parte de tu proyecto TypeScript sin que el compilador genere errores.

ts

Tipos para JSON y Otros Recursos

En ocasiones, es posible que necesites importar recursos JSON u otros tipos de archivos en tu proyecto TypeScript. Puedes declarar tipos para estos recursos también.

Ejemplo para Archivos JSON

Crea un archivo json.d.ts:

ts

Ahora puedes importar archivos JSON en tu proyecto TypeScript:

ts

Trabajar con bibliotecas y dependencias en TypeScript puede parecer un poco complicado al principio, pero entender estos conceptos básicos te ayudará a integrar TypeScript sin problemas en tu proyecto existente. En la siguiente sección, vamos a aprender sobre la refactorización de código y mejoras de tipado.