Ambient Declarations (.d.ts)

TypeScript 🟡 Mid

Definition

Fichiers de declaration (.d.ts) qui decrivent la forme de code JavaScript existant sans implementation. Permettent a TS de typer des libs JS.

Analogie

Comme un plan architectural sans les murs reels — il decrit la structure sans la construire.

Exemple de code

// globals.d.ts
declare const API_URL: string;
declare function legacy(x: number): string;
// Utilisable partout sans import

Cas d'usage

Typer des bibliotheques JavaScript, des variables globales injectees ou du code legacy.

Anti-pattern

Ecrire des .d.ts quand on peut simplement ecrire du .ts — les declarations ne sont utiles que pour du JS pur.

Termes lies

#core#tooling