Programación TypeScript

Apéndice E. Directivas de triple barra

Las directivas de triple barra son sólo comentarios normales de JavaScript que TypeScript busca para hacer cosas como ajustar la configuración del compilador para un archivo específico, o indicar que tu archivo depende de otro archivo. Coloca tus directivas al principio de tu archivo, antes de cualquier código. Las directivas de triple barra tienen este aspecto (cada directiva es una triple barra, ///, seguida de una etiqueta XML):

/// <directive attr="value" />

TypeScript admite un puñado de directivas de triple barra. La Tabla E-1 enumera las que es más probable que utilices:

amd-module

Dirígete a "La Directiva del módulo amd" para saber más.

lib

La directiva lib es una forma de indicar a TypeScript de cuál de los libs de TypeScript depende tu módulo, lo que puedes querer hacer si tu proyecto no tiene un tsconfig.json. Declarar los libs de los que dependes en tu tsconfig.json es casi siempre una mejor opción.

path

Cuando utilices la opción outFile de TSC, utiliza la directiva path para declarar una dependencia de otro archivo, de modo que el otro archivo aparezca antes en tu salida compilada que el archivo dependiente. Si tu proyecto utiliza imports y exports, es probable que nunca utilices esta directiva.

type

Visita "La Directiva de tipos" para saber más sobre la directiva type.

Tabla E-1. Directivas de triple barra

Directiva	Sintaxis	Úsalo para...
amd-module	<amd-module name="MyComponent" />	Declarar nombres de exportación ...