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 bawah5.0.0. - Tilde
~4.19.2: hanya boleh naik patch sampai di bawah4.20.0.
Langkah Update Versi Package Tertentu
Gunakan alur ini untuk satu package, misalnya express:
- Cek versi tersedia:
npm view express versions --json - Pasang versi target:
npm install express@4.19.2 - Periksa hasilnya:
npm list express - Buka
package.jsondanpackage-lock.json, pastikan versinya sama. - Jalankan
npm startdannpm testuntuk 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.jsonagar 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.