Aller au contenu
Interface en ligne de commande et analyse de code

Analyse de l'interface CLI et du code : identifiez automatiquement toutes les chaînes non traduites

Ne passez plus votre temps à rechercher des chaînes codées en dur dans vos fichiers source. L'interface de ligne de commande de Better i18n utilise une analyse syntaxique basée sur l'AST pour analyser l'intégralité de votre base de code, détecter le texte non traduit dans les composants et attributs JSX, signaler les clés manquantes ou inutilisées, et s'intégrer de manière transparente à votre pipeline de CI.

Analyse de code optimisée par AST

Contrairement aux analyseurs basés sur des expressions régulières qui génèrent des faux positifs, Better i18n analyse votre code pour en extraire un arbre syntaxique abstrait, ce qui permet une détection précise des chaînes de caractères en tenant compte du contexte.

Détection des chaînes de caractères codées en dur

Détectez automatiquement toutes les chaînes destinées aux utilisateurs qui ne sont pas encapsulées dans une fonction de traduction, y compris celles contenues dans les éléments enfants JSX et les propriétés des composants.

Analyse syntaxique basée sur l'AST

Analyse votre code source pour en extraire un arbre de syntaxe abstraite, ce qui permet une détection précise et contextuelle qui élimine les faux positifs des analyseurs basés sur les expressions régulières.

Analyse des nœuds de texte JSX

Détecte le contenu textuel non traduit à l'intérieur des éléments JSX, y compris les expressions et les littéraux de modèle affichés directement dans vos composants.

Analyse des attributs JSX

Détecte les chaînes de caractères codées en dur dans les attributs JSX tels que « placeholder », « aria-label » et « title », qui sont souvent omises lors des audits manuels d'internationalisation.

Filtrage intelligent

Ignore les valeurs non traduisibles telles que les noms de classes CSS, les chemins d'importation et les littéraux numériques, afin que vous ne voyiez que les résultats exploitables.

Commandes CLI pour l'audit des traductions

La commande « check » offre une expérience d'audit interactive et conviviale pour les développeurs. Elle compare les clés de traduction utilisées dans votre code source aux clés stockées sur le serveur distant de Better i18n, mettant ainsi en évidence à la fois les clés manquantes qui doivent être traduites et les clés inutilisées qui peuvent être supprimées.

Les modèles de clés dynamiques, tels que les littéraux de modèle, sont détectés automatiquement. Lorsque votre code utilise t(`key. ${variable}`), l'interface CLI reconnaît le segment dynamique et l'inclut dans les rapports de correspondance de modèles, afin qu'aucun élément ne passe inaperçu.

  • Effectuez un audit complet de la traduction à l'aide d'une seule commande de vérification
  • Surface : clés de traduction manquantes qui existent dans le code mais pas dans votre magasin distant
  • Identifiez les clés inutilisées dans votre magasin de données distant qui ne sont plus référencées dans le code
  • Détecter les schémas de clés dynamiques, tels que les littéraux de modèle, et les signaler pour révision
  • Générer des rapports comparatifs entre l'utilisation locale et l'état de la traduction à distance

Formats de sortie flexibles

Les résultats de l'analyse sont disponibles dans plusieurs formats afin de s'adapter à votre flux de travail. Le format de sortie de type ESLint fournit des rapports lisibles par l'utilisateur, avec des références aux fichiers, aux lignes et aux colonnes. Le format JSON fournit des données lisibles par machine pour l'automatisation CI/CD et les outils personnalisés.

Le mode détaillé offre une transparence totale grâce à des journaux d'audit détaillés, des résumés de portée et des informations sur les délais. Les statistiques d'analyse indiquent le nombre de fichiers, les indicateurs de découverte et les données de performance, ce qui vous permet de toujours connaître l'état de votre couverture de traduction.

Sortie au format ESLint

Des rapports lisibles par l'utilisateur, comprenant le chemin d'accès au fichier, le numéro de ligne et les références de colonne, pour une navigation rapide dans n'importe quel éditeur.

Sortie JSON

Des données structurées lisibles par machine, idéales pour l'automatisation CI/CD, les tableaux de bord personnalisés et l'intégration avec d'autres outils.

Mode détaillé

Des journaux d'audit détaillés comprenant des résumés de portée, des informations de chronométrage et des traces de résolution d'espaces de noms à des fins de débogage.

Statistiques de numérisation

Le nombre de fichiers, les indicateurs clés de découverte et les données de performance, pour que vous puissiez à tout moment évaluer l'état de votre couverture de traduction.

DevOps et intégration CI/CD

Intégrez les vérifications de traduction dans votre pipeline de développement existant pour détecter les chaînes manquantes avant qu'elles n'atteignent la production.

1

Intégration du pipeline CI

Ajoutez une étape de vérification à votre workflow d'intégration continue qui provoque l'échec de la compilation si des chaînes non traduites ou des clés manquantes sont détectées.

2

Hooks de pré-commit

Effectuez des analyses sur les fichiers préparés avant chaque validation afin de repérer les chaînes non traduites le plus tôt possible au cours du développement.

3

Analyse au niveau du répertoire

Ciblez des répertoires ou des modèles de fichiers spécifiques afin de n'analyser que les parties de votre base de code qui contiennent du contenu destiné aux utilisateurs.

4

Analyse tenant compte de la portée

Résoudre automatiquement les espaces de noms de traduction grâce au suivi de la portée lexicale, afin que chaque appel à t() soit associé au jeu de clés approprié.

Better i18n CLI : analyse de code spécialement conçue pour la localisation

L'interface CLI de Better i18n combine l'analyse de code basée sur l'AST et la gestion des clés à distance en un seul outil. Analysez votre base de code à la recherche de chaînes codées en dur, comparez leur utilisation locale avec votre base de données de traduction à distance, détectez les clés inutilisées qui alourdissent la taille des paquets et générez des rapports pour votre pipeline d'intégration continue — le tout sans quitter votre terminal.

Analyse tenant compte de la portée

Tracks utilise les appels useTranslations et getTranslations via des portées lexicales, en associant automatiquement chaque appel à t() à son espace de noms correspondant.

Prise en charge des composants serveur

Prise en charge complète des composants serveur asynchrones de Next.js App Router : les appels getTranslations dans le code serveur sont ainsi détectés et contrôlés, tout comme leur utilisation côté client.

Hooks de pré-commit

Utilisez l'option --staged pour lancer des analyses uniquement sur les fichiers en attente de publication, ce qui vous permet de repérer les chaînes non traduites avant leur validation sans ralentir votre flux de travail.

Envoyez vos traductions sans oublier la moindre ligne

L'interface de ligne de commande de Better i18n analyse votre code, détecte toutes les chaînes non traduites et s'intègre à votre pipeline d'intégration continue, de sorte qu'aucun élément ne parvienne en production sans traduction.