Cara menghapus dependency dari package json paling aman adalah menjalankan npm uninstall nama-package dari folder proyek, bukan menghapus barisnya manual. Perintah ini membersihkan package.json, package-lock.json, dan folder node_modules sekaligus. Langkah yang sering terlewat adalah memastikan tidak ada lagi require() atau import yang memanggil package tersebut sebelum dihapus.
Perintah Cepat Menghapus Satu Package
Gunakan npm uninstall untuk package di dependencies maupun devDependencies. npm mendeteksi lokasinya otomatis.
npm uninstall express
npm uninstall lodash
npm uninstall nodemon
expresscontoh dependency produksi.lodashcontoh utility yang sering tidak terpakai.nodemoncontoh devDependency untuk development.
Setelah selesai, buka package.json dan pastikan nama package sudah hilang dari daftar.
Hapus Manual lewat Package.json dan Kapan Dipakai
Edit manual cocok bila ingin menghapus banyak package sekaligus atau merapikan file.
Ikuti langkah berikut:
1. Buka package.json.
2. Hapus baris package dari dependencies, devDependencies, atau optionalDependencies.
3. Jalankan npm install untuk sinkronisasi ulang.
4. Jalankan npm prune bila folder node_modules masih berisi package sisa.
dependenciesdipakai saat aplikasi berjalan.devDependencieshanya dipakai saat development dan testing.optionalDependenciesboleh gagal dipasang tanpa menghentikan instalasi.
Edit manual tanpa npm install membuat package-lock.json tidak sinkron dan instalasi berikutnya bisa tidak konsisten.
Tabel Pilihan Perintah Hapus Dependency
| Tahap | Tindakan | Catatan |
|---|---|---|
| Hapus satu package | npm uninstall nama-package |
Perbarui lockfile otomatis |
| Hapus banyak package | Edit manual lalu npm install |
Cepat untuk bersih-bersih besar |
| Bersihkan sisa instalasi | npm prune |
Hapus package tak terdaftar |
Verifikasi Hapus Sampai Bersih
- Periksa
package.json,package-lock.json, dan foldernode_modules/nama-package. - Jalankan
npm ls nama-packageuntuk memastikan tidak ada sisa. - Cek dependency transitif karena package lain mungkin masih membutuhkannya.
Cari sisa pemakaian di kode dengan pencarian require('nama-package') untuk CommonJS atau import ... from 'nama-package' untuk ES Module. Hapus import tersebut agar server tidak error Cannot find module.
FAQ
Apakah hapus baris package.json saja cukup tanpa npm install?
Tidak cukup, karena node_modules dan package-lock.json belum berubah sampai npm install dijalankan.
Kenapa package masih ada di node_modules setelah uninstall?
Kemungkinan package dipakai sebagai dependency transitif oleh package lain, cek dengan npm ls nama-package.
Apakah npm uninstall otomatis mengubah package-lock.json?
Ya, npm versi modern memperbarui package-lock.json otomatis setiap uninstall berhasil.