Formations — 1 037 leçons en français

Accueil › TypeScript › Migrer progressivement

Migrer progressivement

Migrer et tenir la compilationavance

Personne ne démarre un projet neuf. On hérite d'une base JavaScript, ou d'un TypeScript laxiste. Une migration qui s'arrête à mi-chemin et qu'on abandonne coûte plus cher que pas de migration du tout : elle laisse deux conventions en vigueur. La seule stratégie qui tienne est incrémentale et toujours verte — la compilation passe à chaque commit.

Étape 1 : poser un tsconfig qui ne casse rien

{
  "compilerOptions": {
    "allowJs": true,
    "checkJs": false,
    "strict": true,
    "noEmit": true
  },
  "include": ["src"]
}

allowJs fait entrer les .js dans le programme. checkJs: false les laisse non vérifiés. À cette étape, zéro erreur : le projet compile dès le premier jour, et la chaîne d'intégration continue peut déjà exiger tsc --noEmit.

Étape 2 : vérifier un fichier à la fois

// @ts-check
export function appliquerRemise(prix, taux) {
  return prix * (1 - taux);
}

Un commentaire en tête de fichier, et celui-ci est vérifié. L'inverse existe aussi : // @ts-nocheck éteint un fichier devenu bruyant. On avance fichier par fichier, en commençant par les feuilles — les fichiers qui ne dépendent de rien de non migré.

Étape 3 : renommer, et assumer la dette visible

// @ts-expect-error la signature de envoyer sera corrigée (ticket 412)
envoyer(total, destinataire);

@ts-expect-error supprime l'erreur et échoue si elle disparaît : TS2578 — Unused '@ts-expect-error' directive. La dette se signale toute seule au remboursement. @ts-ignore, lui, reste en place pour toujours.

Préférez toujours @ts-expect-error. C'est la seule dette technique qui se nettoie elle-même.

Les termes à connaître

allowJs

Autorise le compilateur à inclure les fichiers .js dans le projet. Ils sont compilés, mais pas vérifiés.

checkJs

Fait vérifier les fichiers .js comme s'ils étaient du TypeScript. Sans annotations, tout est inféré — et beaucoup échoue.

@ts-nocheck

En première ligne d'un fichier, désactive toute vérification pour ce fichier. L'inverse, // @ts-check, l'active fichier par fichier.

@ts-expect-error

Supprime l'erreur de la ligne suivante, et échoue si cette ligne n'a plus d'erreur. Auto-nettoyant.

@ts-ignore

Supprime l'erreur de la ligne suivante, et ne dit rien quand l'erreur disparaît. Reste en place pour toujours.

Fichier frontière

Un fichier migré qui importe du JavaScript non migré. C'est là que se concentrent les any implicites.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.