Beranda node.js npm pemrograman versi

Mengenal NVM: Alat Wajib Buat Ngatur Versi Node.js

Updated: • 0 • min read
Table of Contents

Pernah nggak sih kamu lagi asyik ngoding proyek Node.js, terus tiba-tiba dapat proyek baru yang ternyata butuh versi Node.js yang beda? Atau mungkin lagi nyoba library baru, eh ternyata library itu cuma kompatibel sama versi Node.js tertentu. Nah, kalau kamu pernah ngalamin itu, pasti tahu betapa ribetnya kalau harus uninstall versi Node.js lama terus install versi baru secara manual. Belum lagi kalau nanti harus balik lagi ke versi lama. Pusing, kan?

Di sinilah NVM datang sebagai penyelamat. NVM itu singkatan dari Node Version Manager. Sesuai namanya, tujuan utamanya adalah membantumu mengelola (manage) berbagai versi Node.js di satu komputer. Jadi, kamu bisa punya Node.js versi 10, 12, 14, 16, 18, bahkan yang paling baru, secara bersamaan, dan bisa pindah-pindah antar versi itu dengan gampang banget cuma pakai beberapa perintah di terminal. Keren, kan?

NVM logo
Image just for illustration

Singkatnya, NVM itu tool yang powerful buat siapa saja yang kerja pakai Node.js dan sering berhadapan dengan isu kompatibilitas versi atau memang perlu testing di berbagai versi Node.js. Ini tool wajib punya buat developer Node.js modern.

Kenapa Kita Butuh NVM? Masalah yang Diselesaikan NVM

Kamu mungkin bertanya, “Memangnya kenapa sih harus punya banyak versi Node.js? Pakai satu versi terbaru saja kan beres?” Sayangnya, dunia development nggak sesederhana itu. Ada beberapa alasan utama kenapa NVM itu penting banget:

Beragam Kebutuhan Proyek

Setiap proyek Node.js itu unik. Proyek yang sudah berjalan lama mungkin dibangun dengan versi Node.js yang lebih tua dan punya dependency (paket/library) yang cuma kompatibel dengan versi Node.js itu. Kalau kamu coba jalankan proyek itu pakai Node.js versi terbaru, bisa jadi ada error atau breaking change (perubahan yang merusak kompatibilitas) yang bikin aplikasimu nggak jalan. Sebaliknya, proyek baru mungkin butuh fitur-fitur terbaru yang cuma ada di Node.js versi paling anyar.

Menghindari “Dependency Hell” Tingkat Node.js

Di ekosistem JavaScript, kita sering dengar istilah dependency hell, yaitu ketika ada konflik antar-versi dependency. Nggak cuma antar-library, konflik ini juga bisa terjadi antara library dengan versi Node.js-nya itu sendiri. Dengan NVM, kamu bisa memastikan setiap proyek berjalan dengan versi Node.js yang tepat, sesuai dengan dependency yang dibutuhkannya, sehingga dependency hell terkait versi Node.js bisa dihindari.

Mempermudah Testing

Kalau kamu seorang pengembang library atau contributor open source, kamu mungkin perlu menguji kode kamu di berbagai versi Node.js untuk memastikan kompatibilitas. NVM bikin proses testing di banyak versi jadi super easy. Kamu tinggal switch versi, jalankan test, switch lagi ke versi lain, dan seterusnya.

Perkembangan Node.js yang Cepat

Node.js itu berkembang terus. Setiap beberapa bulan, ada rilis versi baru, baik itu versi Current yang punya fitur-fitur terbaru, atau versi LTS (Long-Term Support) yang lebih stabil dan direkomendasikan untuk produksi. Dengan NVM, kamu bisa dengan mudah mencoba fitur baru di versi Current tanpa mengganggu proyek production kamu yang mungkin berjalan di versi LTS.

Node.js version cycle
Image just for illustration

Tanpa NVM, setiap kali kamu butuh versi Node.js yang beda, kamu harus uninstall versi yang ada, unduh installer untuk versi yang kamu mau, lalu install. Bayangkan kalau kamu harus melakukan ini beberapa kali sehari! Pasti sangat tidak efisien dan buang-buang waktu. NVM mengatasi masalah ini dengan menyimpan semua versi yang kamu install di satu tempat dan membiarkanmu switch antar-versi dengan cepat.

Bagaimana NVM Bekerja di Balik Layar?

Cara kerja NVM itu sebenarnya cukup sederhana tapi cerdas. Saat kamu menginstal NVM, NVM akan membuat sebuah direktori khusus (biasanya di $HOME/.nvm) tempat semua versi Node.js yang kamu install nantinya disimpan. Setiap versi Node.js diinstal di sub-direktori terpisah di dalam direktori $HOME/.nvm.

Ketika kamu menggunakan perintah nvm use <version>, NVM akan melakukan dua hal utama:
1. Mengatur PATH Lingkungan: NVM akan memanipulasi variabel lingkungan PATH di shell kamu. Variabel PATH ini memberi tahu sistem operasi di mana harus mencari program yang ingin kamu jalankan (seperti node atau npm).
2. Membuat Symlink (Opsional, tergantung NVM dan OS): Di beberapa implementasi atau sistem operasi, NVM mungkin membuat symlink (shortcut) dari lokasi standar di PATH (misalnya /usr/local/bin) ke direktori biner (executable files) dari versi Node.js yang sedang kamu use. Namun, metode manipulasi PATH secara langsung di shell saat itu lebih umum dan lebih fleksibel.

Jadi, saat kamu mengetik node -v atau npm -v, shell kamu akan mencari program node atau npm di direktori yang ditunjuk oleh variabel PATH. Karena NVM sudah mengatur PATH untuk menunjuk ke versi yang sedang aktif, shell akan menemukan dan menjalankan program dari versi Node.js yang kamu pilih barusan.

mermaid graph LR A[Shell Aktif] --> B{nvm use X.Y.Z}; B --> C[NVM Memodifikasi Variabel PATH]; C --> D[PATH Kini Menunjuk ke <br> ~/.nvm/versions/node/X.Y.Z/bin]; D --> E{Eksekusi Perintah <br> 'node' atau 'npm'}; E --> F[Sistem Menjalankan <br> Executable dari Folder Versi X.Y.Z]; F --> G[Output Berdasarkan <br> Versi X.Y.Z];
Diagram: Cara NVM Mengubah Versi Node.js Aktif

Ini jauh lebih efisien daripada menginstal Node.js secara global (melalui installer resmi), karena instalasi global biasanya menempatkan biner Node.js di lokasi sistem (seperti /usr/local/bin di macOS/Linux atau di Program Files di Windows), dan ini overwrite instalasi sebelumnya atau menyebabkan konflik kalau kamu mencoba menginstal versi lain. NVM menjaga semuanya tetap rapi dan terisolasi.

Proses Instalasi Singkat

Instalasi NVM itu sendiri biasanya cukup mudah. Di macOS dan Linux, kamu tinggal menjalankan script yang bisa kamu dapatkan dari repositori GitHub resmi NVM (cari nvm-sh/nvm). Script ini akan mengunduh NVM dan menambahkannya ke konfigurasi shell kamu (seperti .bashrc, .zshrc, atau .profile) supaya NVM otomatis jalan setiap kali kamu buka terminal baru.

Penting: Selalu cek instruksi instalasi terbaru di halaman GitHub resmi NVM, karena metodenya bisa berubah. Hindari menginstal Node.js sebelum menginstal NVM, atau kalau sudah terinstal, sebaiknya uninstall dulu versi globalnya agar tidak ada konflik.

Setelah NVM terinstal dan shell kamu dikonfigurasi ulang (biasanya dengan restart terminal atau menjalankan source ~/.bashrc dsb.), kamu bisa mulai pakai perintah-perintah NVM.

Perintah-Perintah Dasar NVM yang Wajib Kamu Tahu

Menguasai beberapa perintah dasar NVM akan sangat mempermudah hidupmu sebagai developer Node.js. Ini dia perintah-perintah yang paling sering dipakai:

nvm install <version>

Perintah ini digunakan untuk menginstal versi Node.js tertentu. Kamu bisa spesifik banget atau agak umum:

  • nvm install node: Menginstal versi terbaru Node.js.
  • nvm install --lts: Menginstal versi LTS (Long-Term Support) terbaru. Ini biasanya yang direkomendasikan untuk proyek production.
  • nvm install 18.17.1: Menginstal versi spesifik, misalnya Node.js versi 18.17.1.
  • nvm install lts/*: Menginstal versi LTS terbaru dari semua major release yang punya status LTS (misal, kalau ada LTS di versi 16 dan 18, ini akan instal yang terbaru dari keduanya).
  • nvm install lts/hydrogen: Menginstal versi LTS dengan nama kode ‘hydrogen’ (nama kode LTS biasanya berdasarkan abjad).

Saat kamu menjalankan nvm install, NVM akan mengunduh biner Node.js (dan NPM yang sesuai) dan menyimpannya di direktori NVM. Kamu bisa menginstal sebanyak mungkin versi yang kamu butuhkan, selama disk space mencukupi.

nvm use <version>

Nah, ini perintah ajaibnya. Setelah kamu menginstal beberapa versi, kamu bisa beralih antar-versi pakai perintah ini:

  • nvm use node: Menggunakan versi terbaru yang sudah terinstal.
  • nvm use --lts: Menggunakan versi LTS terbaru yang sudah terinstal.
  • nvm use 18.17.1: Menggunakan versi spesifik 18.17.1.
  • nvm use system: Beralih kembali menggunakan versi Node.js yang terinstal secara global (jika ada) atau versi bawaan sistem.

Ketika kamu menjalankan nvm use, NVM akan mengatur ulang variabel PATH di shell saat itu sehingga perintah node dan npm akan merujuk pada versi yang kamu pilih. Penting: Pengaturan ini hanya berlaku untuk shell atau tab terminal yang sedang aktif. Kalau kamu buka terminal baru, dia akan menggunakan versi default (atau versi yang terakhir di-use jika diatur di konfigurasi shell).

nvm list atau nvm ls

Perintah ini akan menampilkan semua versi Node.js yang sudah kamu instal melalui NVM. Versi yang sedang aktif atau sedang kamu gunakan akan ditandai dengan tanda panah hijau atau indikator lainnya.

$ nvm ls
        v14.21.3
        v16.20.2
->      v18.17.1
         system
default -> 18.17.1 (-> v18.17.1)
node -> stable (-> v18.17.1) (default)
lts/* -> lts/hydrogen (-> v18.17.1)
lts/argon -> v6.17.1
lts/boron -> v8.17.0
lts/carbon -> v10.24.1
lts/dubnium -> v12.22.12
lts/erbium -> v14.21.3
lts/fermium -> v16.20.2
lts/gallium -> v16.20.2
lts/hydrogen -> v18.17.1

Contoh output nvm ls

Dari output di atas, kita bisa lihat versi v18.17.1 adalah versi yang sedang aktif (->) dan juga diset sebagai versi default.

nvm current

Perintah singkat ini hanya menampilkan versi Node.js yang sedang aktif atau digunakan di shell kamu saat itu. Berguna kalau kamu lupa versi mana yang lagi kamu pakai.

nvm alias default <version>

Ini perintah yang super penting! Seperti yang dijelaskan tadi, nvm use hanya berlaku untuk sesi terminal saat itu. Supaya terminal baru yang kamu buka otomatis menggunakan versi Node.js tertentu, kamu bisa mengaturnya sebagai versi default:

nvm alias default 18.17.1: Mengatur versi 18.17.1 sebagai versi default. Setiap kali kamu buka terminal baru, NVM akan otomatis menggunakan versi ini.
nvm alias default system: Mengembalikan versi default ke versi Node.js yang terinstal global atau bawaan sistem.

nvm uninstall <version>

Kalau kamu punya banyak versi Node.js yang terinstal dan ada yang sudah nggak dipakai, sebaiknya di-uninstall supaya nggak menuh-menuhin disk space.

nvm uninstall 14.21.3: Menghapus instalasi Node.js versi 14.21.3.

Pastikan kamu nggak meng-uninstall versi yang sedang aktif (nvm current).

Keuntungan Nyata Menggunakan NVM

Setelah tahu cara kerjanya dan perintah dasarnya, makin jelas dong kenapa NVM itu powerful? Ini dia beberapa keuntungan utama menggunakan NVM:

  1. Fleksibilitas Maksimal: Kamu bisa dengan mudah bekerja pada proyek yang butuh versi Node.js yang sangat berbeda tanpa pusing. Pindah dari satu proyek ke proyek lain tinggal ketik nvm use <version> dan selesai.
  2. Isolasi Lingkungan: Setiap versi Node.js yang diinstal oleh NVM punya direktori node_modules dan konfigurasi global NPM sendiri. Ini berarti paket global yang kamu install di satu versi tidak akan mengganggu paket global di versi lain, menghindari konflik yang nggak diinginkan.
  3. Mempermudah Kolaborasi: Kalau kamu kerja tim, dan timmu sepakat pakai versi Node.js tertentu untuk proyek A, kamu bisa dengan mudah menyamakan versi Node.js di mesinmu dengan mesin teman satu tim. Ini mengurangi masalah “it works on my machine!” yang sering bikin frustrasi.
  4. Uji Coba Fitur Baru Aman: Penasaran dengan fitur-fitur terbaru di versi Node.js Current? Instal aja pakai NVM, coba-coba, kalau nggak cocok atau bikin error di kode kamu, tinggal switch balik ke versi LTS tanpa merusak instalasi utama kamu.
  5. Manajemen NPM/Yarn Otomatis: Setiap versi Node.js datang dengan versi NPM yang sesuai. NVM juga mendukung tool manajemen paket lain seperti Yarn. Ketika kamu switch versi Node.js pakai NVM, NVM juga akan memastikan kamu menggunakan versi NPM/Yarn yang kompatibel atau yang terinstal di lingkungan versi Node.js itu.

NVM vs Manual Install
Image just for illustration

Intinya, NVM itu membuat manajemen versi Node.js jadi super simple, efisien, dan meminimalkan potensi masalah akibat perbedaan versi. Ini adalah tool yang sangat disarankan untuk meningkatkan produktivitas dan mengurangi frustrasi saat bekerja dengan ekosistem Node.js.

Skenario Nyata Penggunaan NVM

Supaya lebih kebayang, yuk lihat beberapa contoh skenario di mana NVM itu sangat berguna:

  • Skenario 1: Bekerja di Dua Proyek Berbeda
    Kamu lagi ngerjain proyek A yang sudah jalan setahun terakhir, pakai Node.js 14. Tiba-tiba, bos minta kamu bantuin proyek B yang baru mulai, dibangun pakai Node.js 18 terbaru.

    • Tanpa NVM: Kamu harus uninstall Node 14, install Node 18. Pas mau balik ke proyek A, uninstall Node 18, install Node 14 lagi. Repotnya minta ampun.
    • Dengan NVM: nvm use 14 untuk proyek A, nvm use 18 untuk proyek B. Beralih proyek secepat kamu ngetik perintah.

  • Skenario 2: Menguji Kompatibilitas Kode
    Kamu mengembangkan sebuah library JavaScript yang akan dipakai banyak developer. Kamu ingin memastikan library kamu jalan di Node.js versi 16 LTS dan 18 LTS.

    • Tanpa NVM: Susah banget buat testing otomatis atau manual di kedua versi itu secara paralel tanpa reinstall berulang kali.
    • Dengan NVM: Kamu bisa menulis script testing yang switch antar-versi pakai NVM (nvm use 16, jalankan test, nvm use 18, jalankan test). Ini bikin proses QA (Quality Assurance) kamu jadi lebih mudah dan menyeluruh.

  • Skenario 3: Ikut Kontribusi Open Source
    Kamu ingin berkontribusi ke proyek open source populer yang ternyata masih pakai Node.js versi 12 karena alasan kompatibilitas dengan dependency atau sistem build mereka.

    • Tanpa NVM: Kamu terpaksa downgrade instalasi Node.js utama kamu ke versi 12, yang mungkin akan merusak proyek-proyek kamu yang lain.
    • Dengan NVM: Kamu cukup install Node.js 12 via NVM (nvm install 12) dan switch ke versi itu (nvm use 12) hanya saat kamu sedang mengerjakan proyek open source tersebut. Proyek kamu yang lain tetap aman di versi Node.js yang mereka butuhkan.

Tips dan Trik Saat Menggunakan NVM

Untuk memaksimalkan penggunaan NVM, ada beberapa tips yang bisa kamu terapkan:

Gunakan File .nvmrc

Banyak proyek Node.js modern menyertakan file .nvmrc di root proyek mereka. File ini isinya cuma nomor versi Node.js yang direkomendasikan atau dibutuhkan untuk proyek itu (misalnya, cuma berisi 18.17.1 atau lts/*).

Kalau NVM mendeteksi file .nvmrc di direktori tempat kamu berada (atau di direktori atasnya), kamu bisa menggunakan perintah nvm use tanpa argumen. NVM akan membaca file .nvmrc dan otomatis switch ke versi Node.js yang tertulis di sana. Kalau versi itu belum terinstal, NVM akan memberitahumu dan kamu bisa langsung menginstalnya.

Ini super praktis untuk tim, karena semua anggota tim bisa memastikan mereka menggunakan versi Node.js yang sama hanya dengan masuk ke direktori proyek dan menjalankan nvm use.

Atur Versi Default yang Sesuai

Seperti yang sudah dibahas, gunakan nvm alias default <version> untuk mengatur versi Node.js yang otomatis aktif setiap kali kamu buka terminal baru. Pilih versi yang paling sering kamu gunakan, biasanya versi LTS terbaru.

Keep NVM Updated

NVM juga mengalami perkembangan dan perbaikan bug. Sebaiknya sesekali periksa apakah ada versi terbaru NVM dan lakukan update sesuai panduan di repositori resminya. Proses update NVM biasanya juga mudah, cukup menjalankan script instalasi terbaru.

Pahami Perbedaan Antara Versi yang Diinstal NVM dan Versi Sistem

Penting untuk tahu bahwa NVM menginstal Node.js di direktori terpisah dari instalasi global bawaan sistem operasi. Perintah nvm use system akan mengabaikan instalasi NVM dan beralih menggunakan versi Node.js yang mungkin sudah terinstal di sistemmu sebelum kamu pakai NVM (misal, kalau kamu pernah menginstal Node.js pakai installer dari website resminya). Ini bisa berguna untuk debugging atau kalau ada script sistem yang bergantung pada instalasi global, tapi dalam kebanyakan kasus development, kamu akan lebih sering berinteraksi dengan versi yang dikelola NVM.

Mengatasi Masalah Umum NVM (Troubleshooting)

Meskipun NVM cukup stabil, kadang-kadang ada beberapa masalah umum yang bisa terjadi:

  • NVM Tidak Ditemukan Setelah Instalasi: Setelah menjalankan script instalasi NVM, kamu mungkin perlu menutup dan membuka kembali terminal, atau menjalankan perintah source konfigurasi shell kamu (misalnya source ~/.bashrc atau source ~/.zshrc) agar NVM terload. Pastikan script instalasi NVM berhasil menambahkan baris-baris yang dibutuhkan ke file konfigurasi shell kamu.
  • Perintah node atau npm Masih Menggunakan Versi Lama: Ini biasanya karena shell kamu tidak memuat NVM dengan benar, atau ada instalasi global Node.js yang mendahului NVM di variabel PATH. Cek variabel PATH kamu (echo $PATH) dan pastikan direktori biner NVM (misalnya ~/.nvm/versions/node/<version>/bin) muncul sebelum direktori instalasi Node.js global (misalnya /usr/local/bin).
  • Error Permission Saat Instalasi Node.js: Ini bisa terjadi kalau direktori NVM (~/.nvm) atau sub-direktorinya punya masalah izin. Pastikan pengguna yang kamu pakai punya hak baca/tulis di direktori tersebut. Terkadang menjalankan sudo chown -R $(whoami) ~/.nvm bisa membantu (hati-hati saat menggunakan sudo).
  • Perintah nvm use Tidak Berpengaruh di Terminal Baru: Seperti dijelaskan sebelumnya, nvm use hanya berlaku untuk sesi terminal saat itu. Untuk membuat pengaturan itu permanen untuk terminal baru, gunakan nvm alias default <version>. Pastikan juga konfigurasi shell kamu memuat NVM dengan benar saat terminal dimulai.

Kalau menghadapi masalah, dokumentasi resmi NVM atau mencari solusinya di forum developer seperti Stack Overflow seringkali sangat membantu.

Penutup: NVM, Teman Terbaik Developer Node.js

Jadi, apa yang dimaksud dengan NVM? NVM adalah Node Version Manager, sebuah tool esensial yang membuat hidup developer Node.js jauh lebih mudah. Dengan NVM, kamu bisa menginstal, mengelola, dan beralih antar berbagai versi Node.js dengan cepat dan efisien. Ini membantumu mengatasi masalah kompatibilitas proyek, mempermudah testing, dan menjaga lingkungan development kamu tetap rapi.

Menguasai NVM adalah salah satu langkah kecil tapi berdampak besar dalam meningkatkan produktivitasmu di ekosistem Node.js. Kalau kamu belum pakai, coba deh instal sekarang juga! Kamu pasti akan merasakan manfaatnya.

Gimana, sudah lebih paham kan apa itu NVM dan kenapa penting banget? Atau mungkin kamu punya pengalaman menarik pakai NVM atau tool manajemen versi lain? Jangan ragu berbagi di kolom komentar ya!

Posting Komentar