Programación TypeScript

Apéndice D. Recetas para escribir archivos de declaración para módulos JavaScript de terceros

Este apéndice cubre algunos bloques de construcción y patrones clave que surgen una y otra vez al escribir módulos de terceros. Para profundizar en el tema de la escritura de código de terceros, visita "JavaScript que no tiene declaraciones de tipo en DefinitelyTyped".

Dado que los archivos de declaración de módulos tienen que vivir en archivos .d.ts y, por tanto, no pueden contener valores, cuando declares tipos de módulos tienes que utilizar la palabra clave declare para afirmar que los valores del tipo dado realmente son exportados por tu módulo. La Tabla D-1 ofrece un breve resumen de las declaraciones regulares y sus equivalentes de declaración de tipo.

Tabla D-1. TypeScript y sus equivalentes de sólo tipo

.ts	.d.ts
var a = 1	declare var a: number
let a = 1	declare let a: number
const a = 1	declare const a: 1
function a(b) { return b.toFixed() }	declare function a(b: number): string
class A { b() { return 3 } }	declare class A { b(): number }
namespace A {}	declare namespace A {}
type A = number	type A = number
interface A { b?: string }	interface A { b?: string }

Tipos de exportación

El hecho de que tu módulo utilice exportaciones globales, ES2015 o CommonJS afectará a la forma en que escribas tus archivos de declaración.

Globales

Si tu módulo sólo asigna valores al espacio de nombres global y en realidad no exporta nada, puedes crear un archivo en modo ...