Jangan Asal Ganti Angka, Ini Cara Update Versi Package di Package Json dengan Aman

Cara update versi package di package.json yang aman adalah pasang versi spesifik dengan perintah, bukan edit angka manual. Jalankan npm install nama-package@versi agar npm ikut memperbarui package-lock.json dan memeriksa dependensi. Kesalahan yang sering terjadi adalah mengubah angka di package.json lalu lupa sinkronisasi lockfile.

Arti Angka dan Simbol Versi di Package Json

Versi npm memakai format major.minor.patch. Major berarti perubahan yang bisa merusak kode lama, minor berarti fitur baru yang kompatibel, patch berarti perbaikan bug.

// sebelum
"dependencies": {
  "express": "^4.18.2"
}

// sesudah update patch
"dependencies": {
  "express": "^4.19.2"
}
  • Versi exact seperti 4.19.2: kunci satu versi saja, cocok untuk production yang sensitif.
  • Caret ^4.19.2: boleh naik minor dan patch sampai di bawah 5.0.0.
  • Tilde ~4.19.2: hanya boleh naik patch sampai di bawah 4.20.0.

Langkah Update Versi Package Tertentu

Gunakan alur ini untuk satu package, misalnya express:

  1. Cek versi tersedia: npm view express versions --json
  2. Pasang versi target: npm install express@4.19.2
  3. Periksa hasilnya: npm list express
  4. Buka package.json dan package-lock.json, pastikan versinya sama.
  5. Jalankan npm start dan npm test untuk memastikan aplikasi tidak error.
Tahap Tindakan Catatan
Cek npm view Lihat changelog bila major berubah
Pasang npm install pkg@versi Jangan edit angka manual
Uji npm test Wajib sebelum commit

Update Banyak Package Sekaligus Tanpa Merusak Proyek

Untuk update massal, mulai dari npm outdated untuk melihat package yang tertinggal. Lalu npm update untuk menaikkan versi dalam batas simbol ^ atau ~. Untuk lompat major, gunakan npx npm-check-updates -u lalu npm install.

  • Risiko major update: API bisa berubah dan merusak route Express.
  • Peer dependency: periksa peringatan konflik setelah install, jangan langsung pakai --legacy-peer-deps.
  • Lockfile berubah: commit package-lock.json agar production memakai versi sama.

Perintah aman untuk production adalah npm outdated, npm update --save, lalu uji penuh sebelum deploy.

FAQ

Apakah package-lock.json ikut berubah setelah update?

Ya, bila update memakai npm install maka lockfile ikut diperbarui otomatis.

Kenapa npm install tidak menaikkan versi di package.json?

Karena npm install tanpa nama package hanya mengikuti versi yang sudah tercatat.

Harus pakai ^ atau versi exact untuk production?

Gunakan versi exact untuk API kritis, gunakan ^ bila proyek rutin diuji dan lockfile dicommit.