Formateur TypeScript

TypeScript est un sur-ensemble de JavaScript, mais la syntaxe au niveau des types qu'il ajoute — interfaces, génériques contraints avec `extends`, décorateurs, assertions de type `as`, et déclarations indépendantes uniquement de type — n'a aucune signification dans la grammaire du JavaScript brut et fait qu'un analyseur JavaScript seul échoue directement sur du TypeScript parfaitement valide. Utiliser l'analyseur dédié de TypeScript plutôt que d'essayer de forcer celui de JavaScript à accepter un sur-ensemble de sa propre grammaire est ce qui permet à un fichier plein de génériques et d'interfaces d'être correctement formaté plutôt que rejeté comme erreur de syntaxe dès qu'il utilise une fonctionnalité que JavaScript lui-même n'a pas.

Un fichier `.tsx` combinant syntaxe JSX et annotations de type TypeScript est réellement ambigu à analyser à un endroit précis : une assertion de type entre chevrons comme `<Foo>value` paraît identique au début d'une balise d'élément JSX pour un analyseur à qui l'on n'a pas dit quel dialecte il lit. Sélectionner le mode d'analyse TypeScript-avec-JSX résout correctement cette ambiguïté, donc choisir le bon dialecte à l'avance — plutôt que de supposer qu'un analyseur JavaScript générique le résoudra — compte spécifiquement pour les fichiers de composants mélangeant les deux.

Les décorateurs — les annotations de style `@Component` courantes dans Angular et certains frameworks backend construits sur TypeScript — sont passés par plusieurs étapes de proposition distinctes dans le processus de standardisation du langage, et différentes bases de code peuvent cibler des versions légèrement différentes de cette syntaxe selon quand elles ont été écrites et quelles options de compilateur elles utilisent. Analyser correctement la syntaxe des décorateurs nécessite spécifiquement l'analyseur conscient de TypeScript ; un analyseur JavaScript brut rencontrant un `@` avant une classe ou méthode n'a aucune signification définie vers laquelle se rabattre et rejettera directement le fichier.