Ambient Declarations (.d.ts)

TypeScript 🟡 Mid

Définition

Fichiers de déclaration (.d.ts) qui décrivent la forme de code JavaScript existant sans implémentation. Permettent a TS de typer des libs JS.

Analogie

Comme un plan architectural sans les murs réels — il décrit 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 bibliothèques JavaScript, des variables globales injectées ou du code legacy.

Anti-pattern

Écrire des .d.ts quand on peut simplement écrire du .ts — les déclarations ne sont utiles que pour du JS pur.
#core#tooling

← → au clavier pour passer d'une fiche à l'autre