Bersihkan Proyek dengan Cara Menghapus Dependency dari Package Json

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
  • express contoh dependency produksi.
  • lodash contoh utility yang sering tidak terpakai.
  • nodemon contoh 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.

  • dependencies dipakai saat aplikasi berjalan.
  • devDependencies hanya dipakai saat development dan testing.
  • optionalDependencies boleh 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 folder node_modules/nama-package.
  • Jalankan npm ls nama-package untuk 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.