Programmation TypeScript

Annexe D. Recettes pour la rédaction de fichiers de déclaration pour des modules JavaScript tiers.

Cette annexe couvre quelques éléments et modèles clés qui reviennent souvent lors du typage de modules tiers. Pour une discussion plus approfondie sur le typage du code tiers, va voir "JavaScript qui n'a pas de déclaration de type sur DefinitelyTyped".

Puisque les fichiers de déclaration de module doivent vivre dans des fichiers .d.ts et ne peuvent donc pas contenir de valeurs, lorsque tu déclares des types de module, tu dois utiliser le mot-clé declare pour affirmer que les valeurs du type donné sont réellement exportées par ton module. Le tableau D-1 fournit un bref résumé des déclarations régulières et de leurs équivalents en matière de déclaration de type.

Tableau D-1. TypeScript et ses équivalents de type seulement.

.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 }

Types d'exportations

Le fait que ton module utilise des exportations globales, ES2015 ou CommonJS aura une incidence sur la façon dont tu écris tes fichiers de déclaration.

Globaux

Si ton module ne fait qu'attribuer des valeurs à l'espace de noms global et n'exporte rien, tu peux ...