Ir al contenido
Interfaz de línea de comandos y análisis de código

Análisis de la interfaz de línea de comandos y del código: detecte automáticamente todas las cadenas sin traducir

Deje de buscar a ciegas cadenas codificadas en los archivos fuente. La interfaz de línea de comandos de Better i18n utiliza un análisis sintáctico basado en AST para escanear todo su código, detectar texto sin traducir en componentes y atributos JSX, informar de claves que faltan o que no se utilizan, e integrarse a la perfección en su proceso de integración continua.

Escaneo de código con tecnología AST

A diferencia de los escáneres basados en expresiones regulares, que generan falsos positivos, Better i18n analiza su código en un árbol de sintaxis abstracta para realizar una detección de cadenas precisa y sensible al contexto.

Detección de cadenas fijas

Detecta automáticamente todas las cadenas visibles para el usuario que no estén envueltas en una función de traducción, incluidas las cadenas de los elementos secundarios JSX y las propiedades de los componentes.

Análisis sintáctico basado en AST

Analiza su código fuente y lo convierte en un árbol de sintaxis abstracta para ofrecer una detección precisa y sensible al contexto que elimina los falsos positivos de los escáneres basados en expresiones regulares.

Análisis de nodos de texto en JSX

Detecta contenido de texto sin traducir dentro de elementos JSX, incluidas las expresiones y los literales de plantilla que se representan directamente en sus componentes.

Análisis de atributos JSX

Detecta cadenas codificadas de forma rígida en atributos JSX como «placeholder», «aria-label» y «title», que a menudo pasan desapercibidas durante las auditorías manuales de internacionalización.

Filtrado inteligente

Ignora los valores no traducibles, como los nombres de clases CSS, las rutas de importación y los literales numéricos, para que solo vea resultados sobre los que pueda actuar.

Comandos de la CLI para la auditoría de traducciones

El comando «check» ofrece una experiencia de auditoría interactiva y fácil de usar para los desarrolladores. Compara las claves de traducción utilizadas en su código fuente con las claves almacenadas en el servidor remoto de Better i18n, mostrando tanto las claves que faltan y que necesitan traducción como las claves no utilizadas que pueden eliminarse.

Los patrones de clave dinámicos, como los literales de plantilla, se detectan automáticamente. Cuando su código utiliza t(`key. ${variable}`), la CLI reconoce el segmento dinámico y lo incluye en los informes de coincidencias de patrones, de modo que no se pasa nada por alto.

  • Realice una auditoría completa de la traducción con un solo comando de comprobación
  • Surface no encuentra claves de traducción que existen en el código pero no en su almacén remoto
  • Identifique las claves no utilizadas en su almacén remoto a las que ya no se hace referencia en el código
  • Detectar patrones dinámicos de claves, como literales de plantilla, y marcarlos para su revisión
  • Generar informes comparativos entre el uso local y el estado de la traducción remota

Formatos de salida flexibles

Los resultados del análisis están disponibles en varios formatos para adaptarse a su flujo de trabajo. La salida en formato ESLint ofrece informes legibles para el usuario con referencias a archivos, líneas y columnas. La salida en formato JSON proporciona datos legibles para máquinas, destinados a la automatización de CI/CD y al desarrollo de herramientas personalizadas.

El modo detallado ofrece una gran transparencia gracias a registros de auditoría detallados, resúmenes del alcance e información sobre los tiempos. Las estadísticas de análisis muestran el número de archivos, las métricas de detección y los datos de rendimiento, para que siempre conozca el estado de su cobertura de traducción.

Salida al estilo de ESLint

Informes legibles para el usuario con la ruta del archivo, el número de línea y las referencias de columna, lo que permite una navegación rápida en cualquier editor.

Salida JSON

Datos estructurados legibles por máquina, ideales para la automatización de CI/CD, paneles de control personalizados y la integración con otras herramientas.

Modo detallado

Registros de auditoría detallados con resúmenes del ámbito de aplicación, información sobre la cronología y trazas de resolución de espacios de nombres para la depuración.

Estadísticas de escaneo

Recuento de archivos, métricas clave de descubrimiento y datos de rendimiento para que siempre conozca el estado de su cobertura de traducción.

DevOps e integración de CI/CD

Incorpore comprobaciones de traducción en su proceso de desarrollo actual para detectar las cadenas que faltan antes de que lleguen a producción.

1

Integración del proceso de integración continua

Añada un paso de comprobación a su flujo de trabajo de integración continua (CI) que provoque el fallo de la compilación cuando se detecten cadenas sin traducir o claves que falten.

2

Ganchos de pre-confirmación

Realice análisis de los archivos preparados antes de cada confirmación para detectar las cadenas sin traducir lo antes posible durante el desarrollo.

3

Escaneo con ámbito de directorio

Seleccione directorios o patrones de archivos específicos para analizar únicamente aquellas partes de su código fuente que contengan contenido destinado a los usuarios.

4

Análisis sensible al ámbito

Resolver automáticamente los espacios de nombres de traducción mediante el seguimiento del ámbito léxico, de modo que cada llamada a t() se asigne al conjunto de claves correcto.

Better i18n CLI: análisis de código diseñado para la localización

La interfaz de línea de comandos de Better i18n combina el análisis de código basado en AST con la gestión remota de claves en una sola herramienta. Analice su código en busca de cadenas codificadas de forma rígida, compare el uso local con su almacén de traducciones remoto, detecte claves no utilizadas que aumentan el tamaño del paquete y genere informes para su canalización de integración continua, todo ello sin salir de su terminal.

Escaneo con reconocimiento de ámbito

Tracks utiliza las llamadas a useTranslations y getTranslations a través de ámbitos léxicos, vinculando automáticamente cada llamada a t() a su espacio de nombres correcto.

Compatibilidad con componentes de servidor

Compatibilidad total con los componentes de servidor asíncronos de Next.js App Router, de modo que las llamadas a `getTranslations` en el código del servidor se detectan y revisan junto con el uso en el lado del cliente.

Ganchos de pre-confirmación

Ejecute análisis únicamente en los archivos preparados con el indicador --staged, lo que le permitirá detectar cadenas sin traducir antes de que se confirmen, sin ralentizar su flujo de trabajo.

Envíe las traducciones sin omitir ni una sola cadena

La CLI de Better i18n analiza su código, detecta todas las cadenas sin traducir y se integra en su proceso de integración continua, de modo que nada llega a producción sin una traducción.