Blog

Une vérification i18n pour CI qui ne nécessite pas de clé API

La vérification de localize-dev détecte le texte codé en dur, les formes plurielles manquantes et les traductions obsolètes, marque la ligne dans la demande de tirage, et n’envoie rien nulle part.

Stephen Ufort · 10 novembre 2026 · 2 min de lecture

Une pull request GitHub où la vérification i18n marque une phrase codée en dur à la ligne 226

Localiser une application une fois est la partie facile. La partie difficile est la prochaine version, quand quelqu’un ajoute une phrase en anglais et personne ne remarque qu’elle n’est pas traduite. localize-dev check est un linter pour cela. Il fonctionne hors ligne, ne nécessite pas de compte ni de clé API, et se termine avec le code 1 lorsqu’il trouve un problème, pour faire échouer un job CI.

Ce qu'il rapporte

Je l'ai exécuté sur une petite application React : un composant, des fichiers de langue anglais, espagnol et arabe, et une phrase que quelqu'un a oublié de traduire. Voici la sortie :

npx localize-dev check
  src/components/SignIn.tsx:9  "We'll email you a 6-digit code. No password needed."
⚠️  1 hardcoded string(s) in 1 file(s). Fix with: npx localize-dev run
⚠️  ar: 4 message(s) without a translation in locales/ar.json
Fill them in with: npx localize-dev translate

La première découverte est la phrase oubliée. La seconde est moins évidente. Le fichier arabe contenait files_one et files_other, ce qui semble complet si l'on pense en anglais. L'arabe a besoin de six formes plurielles, donc check signale les quatre manquantes : zero, two, few et many.

Chaque vérification couvre une façon dont une application localisée échoue :

  • Texte codé en dur, trouvé par le même analyseur que celui utilisé par run.
  • Traductions manquantes, comptant chaque forme plurielle dont chaque langue a besoin.
  • Traductions obsolètes : le texte source a changé après sa traduction, trouvé via localize.lock.json.
  • Clés inconnues : un appel t() dont la clé n'est pas dans le fichier source, de sorte que les gens verraient la clé elle-même.
  • Texte qui ne peut pas être traduit là où il se trouve, avec la raison.
  • Avertissements qui ne font pas échouer la tâche : styles gauche et droite qui échouent dans les langues de droite à gauche, texte en CSS et clés qu'aucun code n'utilise.

Marquer la ligne sur la pull request

Lorsqu'il s'exécute dans GitHub Actions, check imprime également des commandes de workflow, que GitHub affiche sous forme d'annotations sur la différence de la pull request :

::error file=src/components/SignIn.tsx,line=9,title=Hardcoded string::"We'll email you a 6-digit code. No password needed." isn't translated. Run localize-dev run (or let the Action open a pull request).
::error file=locales/ar.json,title=Missing ar translations::4 message(s) have no ar translation: signin.files_few, signin.files_many, signin.files_two, signin.files_zero

Vous pouvez l'ajouter comme étape CLI, ou utiliser le mode de vérification de la GitHub Action, qui ne prend pas de clé API :

.github/workflows/i18n.yml
name: i18n
on: pull_request
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: ufortstephen/autolocalize-action@v1
        with:
          mode: check

Pourquoi il n'envoie rien

check ne lit que les fichiers : votre source, vos fichiers de locale et le fichier de verrouillage. Il n'effectue aucun appel réseau, il est donc sûr sur les forks, sur le code privé et sur les runners sans Internet. Il est également gratuit et ne compte pas dans la limite d'un plan.

L'exécuter avant la CI

npx localize-dev check --changed ne regarde que les fichiers modifiés depuis le dernier commit, ce qui le rend rapide. npx localize-dev init --agent --pre-commit ajoute un hook de pré-commit git qui vérifie les fichiers mis en scène. Lorsqu'un problème est quelque chose que vous avez l'intention de laisser, comme un nom de marque ou du texte dans un sélecteur de langue, marquez l'élément avec data-i18n-ignore ou translate="no" et check l'ignorera.

Essayez-le sur votre propre code dans le terrain de jeu, aucun compte requis