Cara mengatasi ReferenceError Node.js paling cepat adalah membaca nama variabel di pesan error, lalu memeriksa ejaan, deklarasi, dan scope di baris tersebut. Error ini berarti kode memanggil variabel yang tidak dikenali JavaScript pada saat itu. Perbaiki deklarasinya dengan const, let, atau import/require yang benar, kemudian jalankan ulang file.
Penyebab ReferenceError Paling Sering di Node.js
ReferenceError hampir selalu berasal dari kode sendiri, bukan dari Node.js. Polanya berulang dan mudah dikenali.
- Typo: userr dipanggil padahal variabelnya user.
- Variabel belum dideklarasi atau dipanggil sebelum diisi nilai.
- Salah scope: variabel di dalam fungsi atau blok if dipanggil dari luar.
- Salah sistem module: memakai require di ES Module atau import di CommonJS.
- Salah konteks runtime: memakai document, window, atau localStorage di Node.js.
Kasus khas lain adalah __dirname is not defined pada ES Module dan require is not defined ketika package.json memakai “type”: “module”. Periksa dulu format module sebelum mengubah logika program.
Tabel Diagnosis Cepat ReferenceError
Baca stack trace dari atas. Nama setelah ReferenceError: adalah variabel bermasalah, angka setelah nama file adalah baris sumbernya.
| Pesan Error | Penyebab | Solusi Awal |
|---|---|---|
| xxx is not defined | Typo atau belum dideklarasi | Cek ejaan dan tambah const atau let |
| require is not defined | File berjalan sebagai ES Module | Ganti require dengan import |
| document is not defined | Browser API dipakai di Node.js | Pindahkan logika ke frontend |
| __dirname is not defined | ES Module tidak menyediakannya | Bangun path dari import.meta.url |
Jika error menunjuk ke file dalam node_modules, penyebabnya kemungkinan dependency rusak atau tidak cocok dengan versi Node.js. Jika menunjuk ke file proyek, perbaiki kode tersebut.
Cara Memperbaiki ReferenceError Langkah demi Langkah
- Jalankan ulang error dengan data minimal supaya baris penyebabnya jelas.
- Periksa ejaan variabel dan pastikan sudah dideklarasi sebelum dipakai.
- Periksa scope fungsi dan blok, pindahkan deklarasi ke scope yang dapat diakses.
- Periksa sistem module lewat package.json dan konsisten memakai CommonJS atau ES Module.
- Tes ulang dan periksa error berikutnya bila nama variabelnya berubah.
- Gunakan node –check namafile.js untuk memeriksa sintaks cepat.
- Gunakan node -v untuk memastikan versi Node.js sesuai kebutuhan syntax.
- Gunakan pesan console sementara tanpa mencetak token atau password.
// CommonJS
const fs = require('fs');
const nama = 'toko';
console.log(nama);
console.log(fs.existsSync('./package.json'));
// ES Module
import fs from 'fs';
const nama = 'toko';
console.log(nama);
console.log(fs.existsSync('./package.json'));
FAQ
Kenapa ReferenceError: require is not defined muncul di Node.js?
Kode memakai require padahal proyek diset sebagai ES Module melalui “type”: “module”.
Apa beda ReferenceError dengan TypeError di Node.js?
ReferenceError berarti variabelnya tidak dikenali, sedangkan TypeError berarti variabel ada tetapi dipakai dengan cara yang salah.
Kenapa variabel sudah dibuat tapi tetap not defined?
Variabel tersebut kemungkinan berada di scope lain atau dipanggil sebelum baris deklarasinya dieksekusi.