Formateur de code TypeScript

TypeScript étend JavaScript avec des annotations de type, des interfaces, des génériques, des énumérations et d'autres fonctionnalités du système de types. Un formateur TypeScript doit gérer toute la mise en forme JavaScript standard ainsi que la syntaxe spécifique aux types comme les deux-points dans les annotations de type (const x: string), les chevrons dans les génériques (Array), les déclarations d'interface et d'alias de type, et la mise en forme des énumérations. Les formateurs JavaScript standard peuvent casser ou ignorer ces constructions spécifiques à TypeScript.

Les deux approches sont valables et largement utilisées. TypeScript (comme JavaScript) dispose de l'insertion automatique de point-virgule (ASI) qui ajoute des point-virgules au moment de l'analyse, de sorte que les omettre fonctionne dans la plupart des cas. Les équipes qui omettent les point-virgules citent un code plus propre et moins de frappes. Les équipes qui les incluent citent l'explicité et l'évitement de rares cas limites de l'ASI. La clé est la cohérence — choisissez un style et appliquez-le à l'ensemble du projet. La plupart des guides de style majeurs (Airbnb, Google) incluent des point-virgules, tandis que StandardJS les omet.

Un ordre d'importation cohérent améliore la lisibilité du code et réduit les conflits de fusion. Lorsque les importations sont triées par ordre alphabétique et regroupées logiquement (packages tiers d'abord, puis modules internes), les développeurs peuvent trouver rapidement des importations spécifiques et éviter les doublons. Les importations non triées provoquent également des différences inutiles dans git — deux développeurs ajoutant des importations dans des positions différentes créent un conflit de fusion même si la modification réelle du code est identique.

Les virgules finales sont des virgules placées après le dernier élément dans les tableaux, objets, paramètres de fonction et paramètres de type. L'utilisation de virgules finales produit des différences git plus propres car l'ajout d'un nouvel élément ne modifie qu'une seule ligne au lieu de deux (la nouvelle ligne plus l'ajout d'une virgule à la dernière ligne précédente). Elles facilitent également la réorganisation des éléments. ES5 autorise les virgules finales dans les tableaux et objets ; ES2017 et TypeScript les autorisent également dans les paramètres de fonction.

Les choix les plus courants sont 80, 100 et 120 caractères. 80 caractères est la norme traditionnelle, issue des limitations de largeur de terminal, et reste le défaut dans Prettier. 100 caractères est un compromis moderne populaire qui prend en charge les annotations de type verbeuses de TypeScript sans renvoi à la ligne excessif. 120 caractères fonctionne bien sur les moniteurs larges mais peut nuire à la lisibilité sur les petits écrans ou dans les vues de comparaison côte à côte. Choisissez en fonction de la configuration typique de l'écran de votre équipe et du flux de travail de revue de code.