Declaración de ambientes de TypeScript

Las declaraciones ambientales en TypeScript se usan para decirle al compilador de TypeScript que el código real existe en otro lugar. La biblioteca de terceros que está escrita en JavaScript simple o CoffeeScript como jquery/angularjs/nodejs, aunque esto es necesario para nuestro uso de TypeScript, siempre podemos escribir declaraciones ambientales y usarlas.

Declaración ambiental:
la extensión de archivos para declaraciones ambientales es (d.ts). Para cada definición de nivel raíz, una extensión de archivo (d.ts) debe tener la palabra clave declare para usarse en TypeScript.

Si tratamos de usar el código fuente que no existe en tiempo de ejecución, entonces el programa se ROMPERÁ sin ADVERTENCIA.

Los archivos de declaraciones ambientales son como archivos docs. Los documentos deben mantenerse actualizados mientras cambia la fuente. De lo contrario, obtendremos errores del compilador si los archivos de declaraciones de Ambient no se actualizan.

Archivo.d.ts

No podemos transcompilar el archivo anterior en JavaScript. El archivo anterior se usará para el tipo de seguridad e intellisense.
Con la palabra clave declare, se pueden declarar las variables ambientales y los métodos.
La sintaxis para la declaración ambiental es:
Sintaxis:

declare module module_name{  
}  

Sintaxis para acceder a los archivos ambientales:

La declaración ambiental se puede entender siguiendo el ejemplo. A continuación, estamos utilizando una biblioteca de JavaScript de terceros con el siguiente código.
Ejemplo:

var TestSum;    
(function (TestSum) {    
   var Cal = (function () {   
      function Cal() {   
      }   
      Cal.prototype.doSum = function (a, b) {  
         return a + b;  
      }  
   })  
})  

Como este es un archivo JS y no tendremos tiempo para volver a escribir esta biblioteca en TypeScript. Pero aún necesitamos usar la función doAdd() con seguridad de tipo, entonces podemos hacerlo usando la declaración ambiental. Vamos a crear un archivo de declaración ambiental.

declare module TestAdd{   
   export class Cal {   
      doAdd(a:number, b:number) : number;   
   }  
}  

Ahora, incluya este archivo de declaración ambiental (CalAdd.d.ts) en nuestro archivo TypeScript.

Main.ts

     
var obj = new TestAdd.Cal();   
console.log("Add: " +obj.doAdd(40, 25)); 

Compile y ejecute el archivo Main.ts con el siguiente comando en la consola:

 $ tsc main.ts  
 $ node Main.js 

Salida:
Obtendremos la siguiente salida.

65