Triple-Slash Directives

TypeScript 🔴 Senior

Definition

Instructions speciales en commentaire (/// <reference ...>) en haut des fichiers pour inclure des types ou des fichiers de declaration. Usage rare avec les modules modernes.

Analogie

Comme une note en marge d'un manuscrit qui dit 'voir aussi le chapitre X' — une reference croisee.

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 referencer des fichiers .d.ts dans des projets sans bundler.

Anti-pattern

Utiliser des triple-slash au lieu d'imports ES modules — methode obsolete dans les projets modernes.

Termes lies

#tooling#legacy