Error missing script berarti npm tidak menemukan nama script yang kamu ketik di dalam package.json pada folder aktif. Cara mengatasi package json missing script paling cepat adalah cocokkan perintah dengan isi blok scripts, pastikan kamu jalan di folder yang berisi package.json yang benar.
Penyebab Missing Script Paling Sering di Node.js
npm membaca script hanya dari package.json di direktori kerja saat perintah dijalankan. Salah satu dari tiga hal ini biasanya jadi pemicu.
- Salah ketik nama script. Tanda: npm run div padahal script bernama dev.
- Script memang belum dibuat. Tanda: blok scripts hanya berisi start, lalu kamu menjalankan npm run dev.
- Perintah jalan di folder yang salah. Tanda: ada beberapa package.json di monorepo, backend, atau frontend, tetapi terminal berhenti di folder induk.
- Perbedaan huruf besar kecil. Tanda: Build tidak sama dengan build di npm.
- File package.json rusak atau tidak terbaca. Tanda: error JSON muncul sebelum daftar script tampil.
Tabel Diagnosis Cepat Missing Script
Jalankan npm run tanpa argumen untuk melihat daftar script yang tersedia di folder aktif.
| Gejala | Penyebab | Pemeriksaan awal |
|---|---|---|
| npm run dev gagal | Script dev tidak ada | Cek npm run, hanya ada start dan build |
| npm run start tidak dikenal | Salah folder proyek | Cek ls, pastikan ada package.json |
| Script ada tapi tetap missing | Salah eja atau case | Buka blok scripts dan salin namanya |
Cara Memperbaiki Missing Script Langkah per Langkah
- Cek posisi folder dengan pwd lalu ls. Pastikan package.json terlihat.
- Buka package.json dan periksa blok scripts.
- Cocokkan nama perintah secara persis, termasuk huruf besar kecil.
- Tambah atau perbaiki script yang hilang, lalu simpan file.
- Jalankan ulang perintah dan verifikasi dengan npm run serta npm pkg get scripts.
{
"name": "backend-app",
"version": "1.0.0",
"scripts": {
"start": "node server.js",
"dev": "node --watch server.js",
"build": "echo build selesai"
}
}
Setelah file disimpan, perintah npm run dev akan terbaca karena nama script sudah cocok. Jangan hapus node_modules untuk kasus ini karena masalahnya ada di konfigurasi, bukan instalasi paket.
FAQ
Kenapa npm start bisa jalan tanpa npm run?
npm memberi pintasan bawaan untuk start dan test, sedangkan script lain wajib memakai npm run nama-script.
Apakah perlu hapus node_modules untuk missing script?
Tidak perlu, karena error ini berasal dari nama script atau folder aktif, bukan dari isi node_modules.
Script sudah ada tapi tetap missing script?
Pindah ke folder yang benar dengan cd nama-folder, lalu salin ulang nama script dari package.json agar ejaannya persis.