Instalasi dan Setup Lingkungan TypeScript untuk Pemula

By | 20 October 2025

Instalasi TypeScript merupakan langkah awal yang penting sebelum mulai belajar bahasa ini. Dengan instalasi yang benar, kamu dapat menulis, mengompilasi, dan menjalankan kode TypeScript secara efisien di berbagai proyek. Artikel ini akan membahas cara instal Node.js dan TypeScript compiler, menulis kode pertama, serta memahami struktur dasar proyek TypeScript.

Sebagai superset dari JavaScript, TypeScript membantu developer menulis kode yang lebih aman dan terstruktur. Namun, sebelum dapat memanfaatkan fitur-fiturnya, kamu perlu menyiapkan lingkungan pengembangan yang tepat. Yuk, kita mulai langkah demi langkah dari instalasi hingga membuat proyek TypeScript pertamamu!

Instal Node.js dan TypeScript Compiler

Sebelum menginstal TypeScript, pastikan sistem kamu sudah memiliki Node.js. Node.js dibutuhkan agar kita dapat menjalankan perintah-perintah seperti npm (Node Package Manager) untuk menginstal compiler TypeScript.

1. Instal Node.js

  • Buka situs resmi: https://nodejs.org

  • Pilih versi LTS (Long Term Support) untuk stabilitas terbaik.

  • Setelah terinstal, cek versi Node.js dan npm dengan perintah:

    node -v
    npm -v

    Jika keduanya menampilkan versi (misalnya v18.17.1), berarti Node.js telah terinstal dengan benar.

2. Instal TypeScript Compiler

Selanjutnya, instal TypeScript secara global menggunakan npm:

npm install -g typescript

Setelah selesai, cek versi TypeScript:

tsc -v

Kamu akan melihat output seperti:

Version 5.3.3

Itu artinya TypeScript sudah siap digunakan!

Menulis Kode Pertama TypeScript

Setelah instalasi berhasil, mari kita tulis program pertama dengan TypeScript untuk memahami alur kompilasinya.

  1. Buat file baru bernama hello.ts

    let message: string = "Hello TypeScript!";
    console.log(message);
  2. Kompilasi file TypeScript ke JavaScript
    Jalankan perintah berikut di terminal:

    tsc hello.ts

    Hasilnya akan muncul file baru bernama hello.js.

  3. Jalankan hasil kompilasi
    Gunakan Node.js untuk menjalankan kode JavaScript:

    node hello.js

Jika muncul teks “Hello TypeScript!” di terminal, maka kamu sudah berhasil menulis dan menjalankan program TypeScript pertamamu!

Struktur Proyek Dasar TypeScript

Agar proyekmu lebih rapi dan mudah dikelola, buatlah struktur direktori seperti berikut:

my-typescript-project/
│
├── src/
│   └── main.ts
│
├── dist/
│   └── (hasil kompilasi .js)
│
└── tsconfig.json

Penjelasan:

  • src/ → berisi file .ts (kode sumber TypeScript)

  • dist/ → hasil kompilasi berupa file .js

  • tsconfig.json → file konfigurasi utama TypeScript

Kamu bisa membuat tsconfig.json secara otomatis dengan perintah:

tsc --init

File ini berisi pengaturan seperti lokasi input/output, versi target JavaScript, dan opsi kompilasi lainnya. Contoh konfigurasi sederhana:

{
  "compilerOptions": {
    "target": "ES6",
    "module": "commonjs",
    "rootDir": "./src",
    "outDir": "./dist",
    "strict": true
  }
}

Setelah file konfigurasi siap, kamu dapat mengompilasi seluruh proyek dengan mudah:

tsc

Semua file .ts di dalam folder src akan otomatis dikompilasi ke dalam folder dist.

Tips Tambahan

  • Gunakan editor seperti Visual Studio Code, karena sudah memiliki dukungan bawaan untuk TypeScript (autocomplete, linting, dan debugging).

  • Gunakan perintah tsc --watch agar compiler otomatis memperbarui hasil setiap kali file .ts disimpan.

  • Buat skrip build di file package.json agar proses kompilasi lebih cepat dan terotomatisasi.

Kesimpulan

Dengan memahami instalasi TypeScript, kamu sudah memiliki pondasi yang kuat untuk melangkah ke tahap berikutnya dalam pengembangan aplikasi modern. Langkah-langkah mulai dari instalasi Node.js, pemasangan TypeScript compiler, hingga pembuatan proyek dasar adalah bagian penting yang tidak boleh dilewati.

Kini kamu siap untuk belajar lebih jauh tentang fitur-fitur lanjutan seperti interface, class, dan type system yang membuat TypeScript menjadi bahasa pilihan para developer profesional.