Typescript Migration JS To TS Step By Step

Ringkasan

TS kompatibel dengan JS. Migrasi bisa bertahap: jalankan TS di samping JS, lalu perketat tipe pelan-pelan.

Konsep Dasar

1. Install: npm i -D typescript.
2. Buat tsconfig.json dengan "allowJs": true agar file .js tetap jalan.
3. Ganti ekstensi .js → .ts satu per satu.
4. Tambah // @ts-check atau checkJs untuk cek file JS tanpa convert.
5. Naikkan strictness bertahap (lihat post terkait).

Cara Kerja / Struktur

json

// tsconfig.json (awal ramah migrasi)
{
  "compilerOptions": {
    "allowJs": true,
    "checkJs": false,
    "noEmit": true,
    "strict": false
  }
}

ts

// utils.ts (mulai dari tipe longgar)
function add(a: number, b: number): number { return a + b; }

Catatan Implementasi

• Jangan nyalakan strict di hari pertama — error meledak & tim demotivasi.
• any sebagai jembatan sementara, ganti bertahap.
• Build tool (tsc/esbuild/vite) menangani transpile; emit JS.

Kesalahan Umum

• Langsung strict: true ke seluruh codebase → ribuan error.
• Menghapus .js sebelum yakin TS build jalan.

Glosarium

• allowJs: izinkan file JS ikut dikompilasi.
• checkJs: cek tipe file JS (lewati @ts-check).

Referensi

• Gradual Strict Mode: any → typed
• tsconfig compilerOptions Penting