¿Qué son los ambientes en TypeScript?

Typescript proporciona una forma de usar bibliotecas de terceros como Node.js, jQuery, AngularJS, etc. de una manera más fácil y segura. Estos se realizan con la ayuda de declaraciones ambientales.

Las declaraciones ambientales son un método que informa al compilador de TypeScript que el código fuente real (como funciones o variables) existe en otro lugar. Si intentamos utilizar estos códigos fuente cuando no existen en tiempo de ejecución, entonces, sin dar ninguna pista, se romperá. Siempre tenemos que escribir declaraciones ambientales si nuestro código TypeScript necesita usar bibliotecas JavaScript de terceros como jQuery, AngularJS, Node.js, etc. 

Cuando se utilizan estas bibliotecas de JavaScript, como jQuery, AngularJS, Node.js, etc., la validación de la finalización del código y la seguridad de tipos se vuelve difícil para un programador de TypeScript. Por lo tanto, las declaraciones ambientales ayudan a integrar directamente otras bibliotecas de JavaScript en TypeScript.

Definición de declaraciones ambientales: los archivos de declaraciones ambientales deben guardarse con la extensión d.ts. Debe tener la palabra clave declare prefijada en cada definición de nivel raíz en los archivos de declaraciones de Ambient con extensión d.ts . Al autor se le aclarará que TypeScript no publicará ningún código. El autor requiere confirmar que en tiempo de ejecución existirá el elemento declarado.

Los archivos de declaraciones ambientales son similares a los archivos doc (el archivo doc debe mantenerse actualizado si la fuente cambia). Por lo tanto, si los archivos de declaración ambiental no se actualizan, devolverán errores de compilación. Por convención, los archivos de declaraciones ambientales se mantienen en un archivo de declaración de tipo que tiene la extensión d.ts. Como se indica a continuación:

Trial.d.ts

El archivo anterior no se puede transcompilar en un archivo JavaScript. Se puede utilizar para completar código y seguridad de tipo.

Ahora, para declarar los métodos y variables ambientales, tenemos que usar la palabra clave declare . La sintaxis para declarar variables ambientales o declaraciones ambientales es la siguiente:

Sintaxis:

declare module module_name {
}

La sintaxis para mencionar los archivos ambientales en el archivo TypeScript del cliente se proporciona a continuación:

/// <reference path = "Trial.d.ts" />

Características: Las siguientes son las características de ambiente en TypeScript:

• Las declaraciones ambientales permiten utilizar de forma segura las bibliotecas de JavaScript populares existentes.
• Las declaraciones ambientales ayudan a integrar directamente otras bibliotecas de JavaScript en TypeScript.
• Las declaraciones ambientales son una forma de informar al compilador sobre variables/funciones/etc existentes.
• Hay una palabra clave declare en la declaración ambiental, lo que significa que declaramos la escritura de una variable sin su implementación, y TypeScript simplemente supondrá que de alguna manera comprenderemos esa implementación (mediante la adición de una etiqueta de secuencia de comandos o cualquier compilador personalizado que tengamos).

Aplicaciones: los ambientes en TypeScript se utilizan para describir la forma de las bibliotecas que no están escritas en TypeScript, para hacerlo debemos declarar la API que revela la biblioteca. Se debe a que las bibliotecas de JavaScript casi no revelan objetos de nivel superior, una mejor manera de representarlos son los espacios de nombres.

Llamamos a una palabra clave declare en la declaración ambiental, lo que significa que declaramos la escritura de una variable sin su implementación, y TypeScript simplemente supondrá que de alguna manera comprenderemos esa implementación (mediante la adición de una etiqueta de secuencia de comandos o cualquier compilador personalizado que tengamos). Generalmente, se describen en archivos .d.ts. Entonces, tenemos que escribir un módulo ambiental para escribir declaraciones de tipo para el código que ya está escrito en JavaScript. Como se declaró anteriormente, estos se definen en un archivo que termina con la extensión de archivo .d.ts.

Entonces, fundamentalmente, las declaraciones ambientales son una garantía que se hace con el compilador. Si las bibliotecas de terceros no existen en tiempo de ejecución y si intentamos usarlas, las cosas se estropearán sin previo aviso. 

Ejemplo 1: Para comprender la declaración ambiental, observe el ejemplo que se proporciona a continuación. Aquí se utiliza la biblioteca de JavaScript de terceros con el código que se indica a continuación:

var TestSum;    
(function (TestSum) {    
   var Calc = (function () {   
      function Calc() {   
      }   
      Calc.prototype.doSum = function (x, z) {  
         return x + z;  
      }  
   })  
})

Al ser un archivo JS, no tenemos tiempo para volver a escribir esta biblioteca dada en TypeScript. Pero, sin embargo, necesita agregar la función doAdd() con seguridad de tipo, luego, al usar la declaración ambiental , podemos hacer esto. Entonces, ahora crearemos un archivo de declaración ambiental.

declare module TestAdd{   
   export class Calc {   
      doAdd(x:number, z:number) : number;   
   }  
}

Ahora, incluiremos este archivo de declaración ambiental (CalAdd.d.ts) en el archivo TypeScript. Se da a continuación –

var obj = new TestAdd.Calc();   
console.log("Add: " +obj.doAdd(60, 15));

Ahora, utilizando el siguiente comando en la consola, compile y ejecute el archivo Main.ts:

$ tsc main.ts
$ node Main.js

Salida: Obtendremos la siguiente salida:

75

Ejemplo 2: Para comprender la declaración ambiental, observe el ejemplo que se proporciona a continuación. Aquí se utiliza la biblioteca de JavaScript de terceros con el código que se indica a continuación:

var TestDif;
(function (TestDif) {    
   var Calc = (function () {   
      function Calc() {   
      }   
      Calc.prototype.doDif = function (x, z) {  
         return x - z;  
      }  
   })  
})

Al ser un archivo JS, no tenemos tiempo para volver a escribir esta biblioteca dada en TypeScript. Pero, sin embargo, necesita agregar la función doSubtract() con seguridad de tipo, luego, al usar la declaración ambiental, podemos hacer esto. Entonces, ahora crearemos un archivo de declaración ambiental.

declare module TestDif{   
   export class Calc {   
      doSubtract(x:number, z:number) : number;   
   }  
}

Ahora, incluiremos este archivo de declaración ambiental en el archivo TypeScript. Se da a continuación:

var obj = new TestDif.Calc();   
console.log("Subtract: " + obj.doSubtract(50, 10));

Ahora, usando el siguiente comando en la consola, compile y ejecute el archivo Main.ts:

$ tsc main.ts 
$ node Main.js

Salida: Obtendremos la siguiente salida:

40