Bikin App.Js Tetap Ramping dengan Cara Memisahkan Router Express Node Js

Cara memisahkan router Express Node Js yang paling sering gagal bukan di sintaks, melainkan di prefix path. Kamu cukup buat file routes/users.js berisi express.Router(), pindahkan semua route lama ke sana tanpa prefix, lalu daftarkan sekali lewat app.use(‘/users’, userRouter) di app.js.

Kebutuhan Sebelum Pisah Router Express

Pastikan proyek sudah jalan dengan satu file app.js atau server.js. Siapkan folder routes/ di samping app.js.

  • Bedakan peran: app menyimpan konfigurasi server, router mengelompokkan route, route menangani satu endpoint, middleware memproses request sebelum handler.
  • Gunakan pola CommonJS bila package.json tidak memakai “type”: “module”: require() untuk memuat modul dan module.exports untuk mengekspor.
  • Simpan logika database atau validasi berat di luar router agar file route tetap tipis.

Langkah Memisahkan Router Express Node Js

1. Buat file routes/users.js dan buat instance router:

const express = require('express');
const router = express.Router();

router.get('/', (req, res) => {
  res.json([]);
});

module.exports = router;

2. Pindahkan route GET, POST, PUT, DELETE dari app.js ke router. Tulis path relatif, contoh router.get(‘/:id’) bukan router.get(‘/users/:id’).

3. Export router lalu daftarkan di app.js:

const express = require('express');
const userRouter = require('./routes/users');

const app = express();
app.use(express.json());
app.use('/users', userRouter);

app.listen(3000);

4. Uji endpoint dengan urutan path lengkap: GET /users/, GET /users/1, POST /users. Kalau memakai versi API, gunakan app.use(‘/api/users’, userRouter) secara konsisten.

Tabel Pola Struktur Router Express

Komponen Fungsi Contoh
app.js Daftar router dan middleware global app.use(‘/users’, userRouter)
routes/users.js Kelola endpoint user router.post(‘/’, handler)
routes/products.js Kelola endpoint produk router.get(‘/:id’, handler)

Gunakan satu gaya prefix. Pilih /users untuk aplikasi kecil atau /api/users untuk REST API berversi. Jangan campur keduanya untuk resource yang sama.

Kesalahan Umum Saat Pisah Router

  • Router tidak diekspor atau salah path require, misalnya menulis ./route/users padahal folder bernama routes.
  • Double prefix seperti /users/users karena app.use(‘/users’) digabung dengan router.get(‘/users’).
  • Lupa express.json() sebelum router sehingga req.body bernilai undefined saat POST atau PUT.

FAQ

Apakah harus memakai controller terpisah?

Tidak wajib. Pisah router dulu, tambah controller kalau handler mulai panjang atau dipakai ulang.

Bagaimana cara memakai parameter ID di router terpisah?

Tulis router.get(‘/:id’) lalu baca lewat req.params.id dan validasi sebelum query database.

Apakah app.use harus dipakai untuk setiap file router?

Ya. Setiap file router perlu satu app.use() dengan prefix berbeda agar endpoint terdaftar.