Comprobando cada traducción antes de escribirla
Marcadores de posición, etiquetas de marcado, cada forma plural de CLDR y sintaxis ICU: lo que localize.dev comprueba en cada traducción automática y lo que sucede con una que falla.
Stephen Ufort · 3 de noviembre de 2026 · 3 min de lectura

La traducción automática falla de maneras que un revisor a menudo pasa por alto. Se traduce un marcador de posición, por lo que {name} se convierte en {nombre} y la aplicación muestra las llaves. Una forma plural regresa con dos formas para un idioma que necesita cuatro. Una llave suelta se desliza en una oración persa y la biblioteca i18n falla cuando intenta renderizarla.
localize.dev comprueba cada traducción con su fuente antes de escribirla en un archivo de localización. Esta publicación recorre cada comprobación, utilizando casos del conjunto de pruebas.
Marcadores de posición: no se añadió ninguno, no se perdió ninguno
Cada {placeholder} en la fuente debe estar en la traducción, sin cambios, y la traducción no puede agregar uno que la fuente no tenga. El verificador informa exactamente qué salió mal:
translationProblem('Hi {name}', 'Hola', 'es', opts);
// → 'it lost {name}'
translationProblem('Hi {name}', 'Hola {nombre}', 'es', opts);
// → "it has {nombre}, which the source doesn't"Hay una excepción. En un mensaje plural, la forma one puede omitir {count}, porque muchos idiomas dicen "un archivo" como palabra en lugar de "1 archivo".
Cada forma plural que el idioma necesita
El inglés tiene dos formas plurales, one y other. El polaco tiene cuatro, el árabe tiene seis y el japonés tiene una. Las formas que necesita un idioma provienen de Intl.PluralRules, los datos CLDR integrados en JavaScript, por lo que nunca es una lista mantenida a mano.
const source = { one: '{count} file', other: '{count} files' };
translationProblem(source, { one: '{count} plik', other: '{count} pliku' }, 'pl', opts);
// → 'no "few", "many" form'
translationProblem(source, { other: '{count}個のファイル' }, 'ja', opts);
// → null (Japanese needs only "other")Cuando la fuente tiene una forma =0 exacta ("No files"), cada traducción también necesita una. Se rechaza un plural que regresa como texto plano, o texto plano que regresa como plural, por tener la forma incorrecta.
Etiquetas de marcado y llaves sueltas
Las oraciones con enlaces o texto en negrita se envían con etiquetas como <a>help center</a>. La traducción puede mover las etiquetas para que se ajusten a su orden de palabras, pero debe mantener el mismo conjunto. Se rechaza una traducción con más llaves no coincidentes que su fuente, lo que detecta el caso persa del conjunto de pruebas antes de que cualquier biblioteca tenga que renderizarlo.
Los mensajes ICU tienen que analizarse
Las aplicaciones Svelte y los archivos ARB de Flutter usan la sintaxis de mensajes ICU. Allí una traducción también tiene que analizarse como ICU. ICU tiene una trampa propia: una comilla simple cita el texto que le sigue, por lo que en francés d'{name} mostraría el texto literal {name} en lugar del valor. localize.dev duplica las comillas simples antes de las llaves antes de comprobar, y luego comprueba que cada marcador de posición que la traducción debería tener siga siendo un argumento real.
Qué sucede cuando una traducción falla
- El idioma fallido se descarta para esa cadena y se olvida la traducción en caché.
- La cadena se envía de nuevo con el motivo añadido a su contexto, por ejemplo: "Se rechazó una traducción anterior: perdió {name}".
- Si la segunda respuesta también falla, la traducción se omite. La ejecución lo informa y la solicitud de extracción la enumera en "Traducciones omitidas".
No se escribe nada roto. Una traducción faltante es visible: la aplicación recurre al idioma de origen para esa cadena, y localize-dev check informa la brecha hasta que se llena. Una rota puede llegar a producción sin ser detectada.
Lo que las comprobaciones no pueden decirle
Estas comprobaciones detectan traducciones que romperían su aplicación. No pueden decir si una traducción es buena. Para ello, localize.dev le permite asignar un revisor por idioma. Sus correcciones van a la solicitud de extracción abierta y a cada ejecución posterior, y un glosario mantiene los términos del producto iguales en todas partes.
Pruébalo en tu propio código en la zona de juegos, no se necesita cuenta