Vai al contenuto
Interfaccia a riga di comando e scansione del codice

Analisi della CLI e del codice: individuate automaticamente ogni stringa non tradotta

Smettete di cercare a tentoni le stringhe hardcoded nei file sorgente. La CLI di Better i18n utilizza un'analisi sintattica basata su AST per scansionare l'intero codice, individuare il testo non tradotto nei componenti e negli attributi JSX, segnalare le chiavi mancanti e inutilizzate e integrarsi perfettamente nella vostra pipeline di CI.

Scansione del codice basata su AST

A differenza degli scanner basati su espressioni regolari che generano falsi positivi, Better i18n analizza il vostro codice trasformandolo in un albero sintattico astratto (AST) per un rilevamento delle stringhe preciso e sensibile al contesto.

Rilevamento delle stringhe hardcoded

Individuare automaticamente tutte le stringhe visibili all'utente che non sono racchiuse in una funzione di traduzione, comprese le stringhe presenti nei figli JSX e nelle proprietà dei componenti.

Analisi sintattica basata su AST

Analizza il codice sorgente trasformandolo in un albero di sintassi astratta (AST) per consentire un rilevamento preciso e sensibile al contesto, eliminando i falsi positivi tipici degli scanner basati su espressioni regolari.

Analisi dei nodi di testo JSX

Rileva i contenuti testuali non tradotti all'interno degli elementi JSX, comprese le espressioni e i letterali di template visualizzati direttamente nei vostri componenti.

Analisi degli attributi JSX

Individua stringhe hardcoded negli attributi JSX quali placeholder, aria-label e title, che spesso sfuggono durante i controlli manuali di internazionalizzazione.

Filtraggio intelligente

Ignora i valori non traducibili, come i nomi delle classi CSS, i percorsi di importazione e i valori numerici, in modo da visualizzare solo i risultati su cui è possibile intervenire.

Comandi CLI per il controllo delle traduzioni

Il comando «check» offre un'esperienza di controllo interattiva e intuitiva per gli sviluppatori. Confronta le chiavi di traduzione utilizzate nel codice sorgente con quelle memorizzate sul server remoto di Better i18n, evidenziando sia le chiavi mancanti che necessitano di traduzione sia quelle inutilizzate che possono essere eliminate.

I modelli di chiave dinamici, come i letterali di template, vengono rilevati automaticamente. Quando il codice utilizza t(`key. ${variable}`), la CLI riconosce il segmento dinamico e lo include nei report relativi alla corrispondenza dei modelli, in modo che nulla sfugga all'attenzione.

  • Eseguire una verifica completa della traduzione con un unico comando di controllo
  • Surface: chiavi di traduzione mancanti che esistono nel codice ma non nel Suo archivio remoto
  • Individuare le chiavi inutilizzate nel proprio archivio remoto che non sono più richiamate nel codice
  • Individuare modelli dinamici di chiavi, come i letterali di template, e contrassegnarli per la revisione
  • Generare report comparativi tra l'utilizzo locale e lo stato della traduzione remota

Formati di output flessibili

I risultati della scansione sono disponibili in diversi formati per adattarsi al vostro flusso di lavoro. L'output in stile ESLint fornisce report di facile lettura con riferimenti a file, righe e colonne. L'output JSON fornisce dati leggibili dal sistema per l'automazione CI/CD e strumenti personalizzati.

La modalità dettagliata offre una trasparenza completa grazie a registri di controllo dettagliati, riepiloghi dell'ambito di analisi e informazioni sui tempi. Le statistiche di scansione mostrano il numero di file, le metriche di individuazione e i dati sulle prestazioni, consentendovi di conoscere in ogni momento lo stato della copertura della traduzione.

Output in stile ESLint

Rapporti di facile consultazione con percorso del file, numero di riga e riferimenti alle colonne per una navigazione rapida in qualsiasi editor.

Output JSON

Dati strutturati leggibili da macchina, ideali per l'automazione CI/CD, i dashboard personalizzati e l'integrazione con altri strumenti.

Modalità dettagliata

Registri di audit dettagliati con riepiloghi dell'ambito, informazioni temporali e tracce di risoluzione degli spazi dei nomi per il debug.

Statistiche di scansione

Numero di file, indicatori chiave di monitoraggio e dati sulle prestazioni, per avere sempre un quadro chiaro dello stato della vostra copertura traduttiva.

DevOps e integrazione CI/CD

Integra i controlli delle traduzioni nella tua pipeline di sviluppo esistente per rilevare le stringhe mancanti prima che raggiungano la produzione.

1

Integrazione della pipeline CI

Aggiunga una fase di verifica al Suo flusso di lavoro CI che interrompa la compilazione qualora vengano rilevate stringhe non tradotte o chiavi mancanti.

2

Hook pre-commit

Eseguite delle verifiche sui file inseriti nello staging area prima di ogni commit, al fine di individuare le stringhe non tradotte il prima possibile nel corso dello sviluppo.

3

Scansione a livello di directory

Selezionate directory o modelli di file specifici per eseguire la scansione solo delle parti del vostro codice che contengono contenuti destinati agli utenti.

4

Analisi sensibile all'ambito

Risolvere automaticamente gli spazi dei nomi delle traduzioni tramite il tracciamento dell'ambito lessicale, in modo che ogni chiamata a t() venga associata al set di chiavi corretto.

Better i18n CLI: scansione del codice pensata per la localizzazione

La CLI di Better i18n combina l'analisi del codice basata su AST con la gestione remota delle chiavi in un unico strumento. Analizzi il proprio codice alla ricerca di stringhe hardcoded, confronti l'utilizzo locale con il proprio archivio di traduzioni remoto, individui le chiavi inutilizzate che aumentano le dimensioni dei pacchetti e generi report per la propria pipeline di CI — il tutto senza uscire dal terminale.

Scansione sensibile all'ambito

Tracks utilizza le chiamate useTranslations e getTranslations attraverso gli ambiti lessicali, associando automaticamente ogni chiamata a t() al namespace corretto.

Supporto ai Server Component

Supporto completo per i componenti server asincroni di Next.js App Router, in modo che le chiamate a `getTranslations` nel codice server vengano rilevate e controllate insieme all'utilizzo lato client.

Hook pre-commit

Eseguite le scansioni solo sui file in fase di preparazione utilizzando il flag --staged, in modo da individuare le stringhe non tradotte prima che vengano salvate, senza rallentare il vostro flusso di lavoro.

Inviare le traduzioni senza tralasciare nemmeno una riga

La CLI di Better i18n analizza il vostro codice, individua ogni stringa non tradotta e si integra nella vostra pipeline di integrazione continua, in modo che nulla arrivi in produzione senza una traduzione.