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
.jsdans le projet. Ils sont compilés, mais pas vérifiés.- checkJs
Fait vérifier les fichiers
.jscomme 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
anyimplicites.
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.