Triple-Slash Directives

TypeScript 🔴 Senior

Définition

Instructions spéciales en commentaire (/// <référence ...>) en haut des fichiers pour inclure des types ou des fichiers de déclaration. Usage rare avec les modules modernes.

Analogie

Comme une note en marge d'un manuscrit qui dit 'voir aussi le chapitre X' — une référence croisée.

Exemple de code

/// <reference types="node" />
/// <reference path="./legacy.d.ts" />
// Charge les types node et le fichier legacy

Cas d'usage

Inclure des types globaux (DOM, Node) ou référencer des fichiers .d.ts dans des projets sans bundler.

Anti-pattern

Utiliser des triple-slash au lieu d'imports ES modules — méthode obsolète dans les projets modernes.

Termes liés

#tooling#legacy

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