Encontrar y rellenar claves de react-i18next que faltan
Un common.json alemán que se quedó atrás respecto al inglés no rompe el build. i18next recurre al inglés o muestra la clave, y nadie lo nota hasta que lo nota un usuario. Abajo, un comando encuentra los huecos y otro los rellena.
KAERIS ha traducido esta página y revisado cada línea traduciéndola de vuelta. Un hablante nativo aún no la ha revisado. Original en inglés
El proyecto de ejemplo
Un pequeño proyecto react-i18next: la fuente en inglés y un archivo alemán que se quedó atrás. Los comandos de abajo se ejecutaron exactamente sobre estos archivos.
{
"header": {
"greeting": "Hi, {{name}}!",
"signOut": "Sign out"
},
"cart": {
"items_one": "{{count}} item in your cart",
"items_other": "{{count}} items in your cart",
"checkout": "Go to checkout",
"terms": "By paying you accept the <1>terms</1>."
}
}
{
"header": {
"greeting": "Hallo, {{name}}!",
"signOut": "Abmelden"
},
"cart": {
"items_one": "{{count}} Artikel im Warenkorb",
"checkout": "Zur Kasse",
"terms": "Mit der Zahlung akzeptieren Sie die AGB."
}
}
1. Encontrar lo que falta
kaeris check compara cada traducción con el archivo fuente. Funciona sin conexión, sin clave ni cuenta, y termina con código 1 si encuentra un problema, así que un job de CI puede detenerse en él.
$ npx kaeris check --source public/locales/en/common.json --langs de
✗ de: 1 missing key(s): cart.items_other
✗ de: 2 translation fault(s):
cart.terms: lost inline tag </1>
cart.terms: lost inline tag <1>
✗ 1 missing key, 2 translation faults
2. Traducir solo las claves que faltan
--only-new envía solo las claves que le faltan al archivo alemán y las añade. Las líneas que ya están en el archivo se quedan como están, incluidas las rotas. El comando está en el paquete de Python: pip install kaeris.
$ kaeris translate public/locales/en/common.json --langs de --only-new
→ no key: free demo limits 10,000 chars per file, 8 languages per run, get a key: kaeris.dev/developer
→ de: 1 new key(s) to translate
→ Run: openai/gpt-6-luna · Free · 1/1 languages · 1 strings · 4.4s
28 charged
✓ Translation QA: no placeholder loss, no overflow risks
✓ de: merged 1 key(s) → public/locales/de/common.json
→ 5 key(s) already exist in de but nothing in kaeris.lock vouches for them, so they were left alone AND left unlocked. If the source changed after those files were made, those edits are NOT translated. Re-run once with --no-only-new to rebuild them, or with --assume-current if the files are known to match.
{
"header": {
"greeting": "Hallo, {{name}}!",
"signOut": "Abmelden"
},
"cart": {
"items_one": "{{count}} Artikel im Warenkorb",
"checkout": "Zur Kasse",
"terms": "Mit der Zahlung akzeptieren Sie die AGB.",
"items_other": "{{count}} Artikel in Ihrem Warenkorb"
}
}
3. Comprobar de nuevo
Las claves que faltaban están rellenas. Lo que queda ya estaba roto antes de esta ejecución: corrija esas líneas a mano o vuelva a traducir todo el archivo con --no-only-new.
$ npx kaeris check --source public/locales/en/common.json --langs de
✗ de: 2 translation fault(s):
cart.terms: lost inline tag </1>
cart.terms: lost inline tag <1>
✗ 2 translation faults
Ejecutado el 2 de noviembre de 2026 en el plan gratuito, sin clave: npx kaeris 0.2.42 para la comprobación, kaeris 0.2.42 de PyPI para la traducción. Salida tal como se imprimió, salvo las líneas de progreso y la ruta de la carpeta local.
Qué detecta kaeris check en react-i18next
Claves que faltan, sufijos de plural incluidos
Una clave que tiene la fuente y no la traducción, como
cart.items_othercuando solo se copió_one.{{name}}perdido o renombradoLas interpolaciones se comparan línea a línea.
{{Name}}en lugar de{{name}}cuenta como una perdida y una inventada.Etiquetas
<Trans>Las etiquetas numeradas como
<1>terms</1>deben volver, o el enlace dentro de la frase desaparece.Aún no se comprueba
Claves de plural que un idioma necesita y el inglés no tiene, como
_fewy_manyen polaco.
Cuánto cuesta
kaeris checkes gratisSe ejecuta en su máquina: sin clave, sin cuenta, sin límite.
Traducir empieza gratis
Sin clave: 10.000 caracteres por archivo, 300.000 al día, hasta 8 idiomas por ejecución. Una clave gratuita lo sube a 50.000 caracteres por archivo y 1,5 M al mes. El volumen cuenta los caracteres una vez por idioma de destino.
Más allá del plan gratuito
Lifetime cuesta $79 una sola vez y funciona con su propia clave de OpenRouter, así que el modelo se paga aparte. Pro cuesta $19 al mes o $190 al año, por 12 M de caracteres al mes. Precios
Preguntas
¿Encuentra claves usadas en el código pero ausentes de los archivos?
No. kaeris check compara los archivos de idioma entre sí. Ejecute antes un extractor como i18next-cli para que el archivo inglés tenga todas las claves; a partir de ahí sigue la comprobación.
¿Qué estructuras de carpetas funcionan?
locales/en/common.json junto a locales/de/common.json, o en.json junto a de.json. La comprobación busca donde escribe translate.
¿Puede ejecutarse en CI?
Sí. npx kaeris check termina con código 1 si encuentra un problema. Recetas: GitHub Actions, GitLab CI, pre-commit.
Seguir adelante
Referencia de check · Referencia de la CLI · Comprobación gratuita en el navegador · Traducir en el navegador
Otros stacks: next-intl · vue-i18n · Flutter · iOS · Android