Pindah dari Require ke Import dengan Cara Menggunakan Type Module Package Json

Tambahkan "type": "module" ke package.json agar semua file .js dibaca Node.js sebagai ES Module, lalu ganti require() dan module.exports menjadi import dan export. Kesalahan yang paling sering terlewat adalah import file lokal tanpa ekstensi, padahal ES Module mewajibkan ekstensi eksplisit seperti ./db.js.

Efek Menambah Type Module di Package Json

Pengaturan ini mengubah sistem module default proyek. File .js otomatis memakai sintaks ES Module, sedangkan file .cjs tetap memakai CommonJS.

CommonJS memakai require() untuk memuat module dan module.exports untuk mengekspor nilai. ES Module memakai import dan export yang dianalisis secara statis sebelum kode berjalan.

Perubahan ini berdampak langsung. Variabel __dirname dan __filename tidak tersedia, import JSON butuh atribut khusus, dan ekstensi file lokal menjadi wajib.

Kebutuhan Sebelum Mengaktifkan Type Module

  • Gunakan Node.js 14.8 ke atas untuk ES Module stabil, idealnya Node.js 18 atau 20.
  • Petakan struktur file: .js menjadi ESM, .mjs selalu ESM, .cjs selalu CommonJS.
  • Periksa dependency lama karena beberapa package CommonJS tidak kompatibel penuh dengan import.

Tetap pakai CommonJS bila proyek memakai banyak require dinamis, __dirname di banyak file, atau dependency lama yang belum mendukung ESM. Salin isi package.json ke file cadangan sebelum mengubahnya.

Langkah Mengaktifkan dan Memakai Type Module

1. Tambahkan type module ke package.json:

{
  "name": "backend-app",
  "type": "module",
  "main": "server.js"
}

2. Ubah server.js ke import dan export:

import express from "express";
import { koneksiDb } from "./db.js";

const app = express();
koneksiDb();
app.listen(3000);

3. Sesuaikan semua import lokal dengan ekstensi file, lalu jalankan ulang dengan node server.js.

Untuk mencampur kode lama, simpan file tersebut sebagai .cjs. Contohnya legacy.cjs tetap boleh memakai require(), lalu dimuat dari ESM dengan import biasa atau createRequire.

Tabel Error Setelah Type Module Aktif

Masalah Penyebab Solusi
require is not defined Kode CommonJS berjalan sebagai ESM Ganti ke import atau ubah file jadi .cjs
__dirname is not defined Variabel khusus CommonJS tidak tersedia Buat dari import.meta.url memakai path dan url
Unexpected token export Campuran sintaks ESM dan CommonJS Samakan ekstensi file dan sintaks module

Import lokal seperti import "./db" akan gagal. Tulis lengkap import "./db.js".

FAQ

Apakah type module wajib untuk pakai import?

Tidak, file .mjs tetap bisa memakai import tanpa pengaturan tersebut.

Bagaimana tetap pakai require setelah type module aktif?

Simpan file lama sebagai .cjs atau buat require manual lewat createRequire.

Kenapa __dirname error setelah pindah ke type module?

Karena __dirname hanya milik CommonJS, gantilah dengan turunan import.meta.url.