Lewati ke konten
CLI & Pemindaian Kode

CLI & Pemindaian Kode: Temukan Setiap String yang Belum Diterjemahkan Secara Otomatis

Hentikan pencarian manual string hardcoded di file sumber. CLI Better I18N menggunakan penguraian berbasis AST untuk memindai seluruh kode, mendeteksi teks yang belum diterjemahkan di komponen dan atribut JSX, melaporkan kunci yang hilang dan tidak digunakan, serta terintegrasi seamlessly ke pipeline CI Anda.

Pemindaian Kode Berbasis AST

Berbeda dengan pemindai berbasis regex yang menghasilkan false positive, Better I18N mengurai kode Anda menjadi Abstract Syntax Tree untuk deteksi string yang presisi dan peka konteks.

Deteksi String yang Ditetapkan Secara Langsung

Temukan secara otomatis setiap teks yang terlihat oleh pengguna yang tidak dibungkus dalam fungsi terjemahan, termasuk teks dalam elemen anak JSX dan properti komponen.

Parsing Berbasis AST

Menganalisis kode sumber Anda menjadi Pohon Sintaksis Abstrak untuk deteksi yang akurat dan sensitif terhadap konteks, sehingga dapat menghilangkan hasil positif palsu yang sering ditemui pada pemindai berbasis regex.

Pemindaian Node Teks JSX

Mendeteksi konten teks yang belum diterjemahkan di dalam elemen JSX, termasuk ekspresi dan literal templat yang ditampilkan langsung di dalam komponen Anda.

Pemindaian Atribut JSX

Mendeteksi string yang ditulis secara langsung dalam atribut JSX seperti placeholder, aria-label, dan title yang sering terlewatkan selama proses audit i18n manual.

Penyaringan Cerdas

Mengabaikan nilai-nilai yang tidak dapat diterjemahkan, seperti nama kelas CSS, jalur impor, dan nilai numerik, sehingga Anda hanya melihat hasil yang dapat ditindaklanjuti.

Perintah CLI untuk Audit Terjemahan

Perintah check menyediakan pengalaman audit yang interaktif dan ramah developer. Perintah ini membandingkan kunci terjemahan yang digunakan dalam kode sumber Anda dengan kunci yang tersimpan di remote Better I18N, menampilkan kunci yang hilang yang perlu diterjemahkan dan kunci yang tidak digunakan yang dapat dibersihkan.

Pola kunci dinamis seperti template literal terdeteksi secara otomatis. Ketika kode Anda menggunakan t(`key.${variable}`), CLI mengenali segmen dinamis dan menyertakannya dalam laporan yang dicocokkan dengan pola, sehingga tidak ada yang terlewat.

  • Lakukan audit terjemahan menyeluruh dengan satu perintah pemeriksaan
  • Surface tidak menemukan kunci terjemahan yang ada dalam kode tetapi tidak ada di penyimpanan jarak jauh Anda
  • Identifikasi kunci yang tidak terpakai di penyimpanan jarak jauh Anda yang tidak lagi dirujuk dalam kode
  • Mendeteksi pola kunci dinamis seperti literal templat dan menandainya untuk ditinjau
  • Hasilkan laporan perbandingan antara penggunaan lokal dan status terjemahan remote

Format Output yang Fleksibel

Hasil pemindaian tersedia dalam berbagai format agar sesuai dengan alur kerja Anda. Keluaran bergaya ESLint menghasilkan laporan yang mudah dibaca manusia dengan referensi berkas, baris, dan kolom. Keluaran JSON menyediakan data yang dapat dibaca mesin untuk otomatisasi CI/CD dan perangkat khusus.

Mode verbose memberikan transparansi mendalam dengan log audit terperinci, ringkasan lingkup, dan informasi waktu. Statistik pemindaian menampilkan jumlah file, metrik penemuan, dan data performa sehingga Anda selalu mengetahui kondisi cakupan terjemahan Anda.

Output Bergaya ESLint

Laporan yang mudah dibaca manusia dengan referensi jalur file, nomor baris, dan kolom untuk navigasi cepat di editor mana pun.

Output JSON

Data terstruktur yang dapat dibaca mesin, ideal untuk otomasi CI/CD, dasbor kustom, dan integrasi dengan tooling lainnya.

Mode Verbose

Log audit terperinci dengan ringkasan lingkup, informasi waktu, dan jejak resolusi namespace untuk keperluan debugging.

Statistik Pemindaian

Jumlah file, metrik penemuan kunci, dan data performa sehingga Anda selalu mengetahui kondisi cakupan terjemahan Anda.

DevOps & Integrasi CI/CD

Integrasikan pemeriksaan terjemahan ke dalam alur pengembangan yang sudah ada untuk mendeteksi string yang hilang sebelum mencapai produksi.

1

Integrasi Pipeline CI

Tambahkan langkah pemindaian ke alur kerja CI Anda yang menghentikan build ketika string yang belum diterjemahkan atau kunci yang hilang terdeteksi.

2

Pre-Commit Hooks

Jalankan pemindaian pada file yang di-stage sebelum setiap commit untuk mendeteksi string yang belum diterjemahkan sedini mungkin dalam proses pengembangan.

3

Pemindaian Berbasis Direktori

Targetkan direktori atau pola file tertentu untuk memindai hanya bagian kode yang berisi konten yang menghadap pengguna.

4

Analisis Berbasis Lingkup

Secara otomatis menyelesaikan namespace terjemahan melalui pelacakan lingkup leksikal sehingga setiap pemanggilan t() dipetakan ke set kunci yang tepat.

Better I18N CLI: Pemindaian Kode yang Dirancang untuk Lokalisasi

CLI Better I18N menggabungkan pemindaian kode berbasis AST dengan manajemen kunci jarak jauh dalam satu alat. Pindai kode untuk string hardcoded, bandingkan penggunaan lokal dengan toko terjemahan jarak jauh, deteksi kunci yang tidak digunakan yang memperbesar ukuran bundle, dan buat laporan untuk pipeline CI Anda — semua tanpa meninggalkan terminal.

Pemindaian Berbasis Lingkup

Melacak pemanggilan useTranslations dan getTranslations melalui lingkup leksikal, mengikat setiap pemanggilan t() ke namespace yang tepat secara otomatis.

Dukungan Server Component

Dukungan penuh untuk komponen server async Next.js App Router, sehingga pemanggilan getTranslations dalam kode server terdeteksi dan diaudit bersama penggunaan sisi klien.

Pre-Commit Hooks

Lakukan pemindaian hanya pada berkas yang sedang dalam tahap persiapan dengan menggunakan opsi --staged, sehingga string yang belum diterjemahkan dapat terdeteksi sebelum disimpan tanpa memperlambat alur kerja Anda.

Rilis Terjemahan Tanpa Melewatkan Satu String pun

CLI Better I18N memindai kode Anda, mendeteksi setiap string yang belum diterjemahkan, dan cocok dengan pipeline CI Anda sehingga tidak ada yang mencapai produksi tanpa terjemahan.