Hanya Satu Route yang Perlu Auth? Cara Membuat Middleware per Route Express

Sisipkan fungsi middleware sebagai argumen di antara path dan handler. Pola ini membuat pengecekan hanya jalan di route tersebut, route lain tetap terbuka tanpa auth. Cara yang sering terlewat: Express membaca argumen dari kiri ke kanan, jadi middleware wajib diposisikan sebelum fungsi handler.

Kebutuhan dasar sebelum pasang middleware per route

Pastikan tiga hal ini sudah siap agar middleware tidak error saat dipasang:

  • File app.js Express dan express.Router() sudah bisa menerima request.
  • Fungsi middleware berbentuk (req, res, next) dan memanggil next() saat lolos.
  • Pisahkan tujuan middleware:
    auth untuk izin akses, validasi untuk cek body atau params, logging untuk catat request.

Langkah pasang middleware hanya di satu route Express

Ikuti urutan ini untuk melindungi satu endpoint tanpa mengunci endpoint lain.

1. Buat fungsi middleware cekAuth atau validasi minimal. Kirim status 401 atau 400 jika gagal, panggil next() jika lolos.

2. Sisipkan sebagai argumen kedua: app.get('/admin', cekAuth, handler).

3. Terapkan pola array untuk dua lapis: app.post('/admin', [cekAuth, validasiInput], handler).

4. Uji route terlindungi versus route publik. Buka /admin dan /public lalu bandingkan responsnya.

const express = require('express');
const app = express();
app.use(express.json());

function cekAuth(req, res, next) {
  if (!req.headers.authorization) {
    return res.status(401).json({ message: 'Unauthorized' });
  }
  next();
}

function validasiInput(req, res, next) {
  if (!req.body.nama) {
    return res.status(400).json({ message: 'Nama wajib diisi' });
  }
  next();
}

app.get('/public', (req, res) => {
  res.json({ message: 'Bebas diakses' });
});

app.get('/admin', cekAuth, (req, res) => {
  res.json({ message: 'Halo admin' });
});

app.post('/admin', [cekAuth, validasiInput], (req, res) => {
  res.status(201).json({ message: 'Data tersimpan' });
});

app.listen(3000);

Tabel pola penempatan middleware di Express

Pilih per route kalau hanya satu atau dua endpoint yang butuh perlakuan khusus.

Pola Fungsi Contoh
Per route Jalan di satu endpoint app.get('/admin', cekAuth, handler)
Per router Jalan di semua route dalam router router.use(cekAuth)
Global Jalan di semua request app.use(logger)

Kesalahan yang bikin middleware per route gagal jalan

  • Lupa panggil next() sehingga request menggantung dan browser terus loading.
  • Urutan argumen terbalik, misalnya handler ditulis sebelum cekAuth.
  • Memakai app.use(cekAuth) untuk kasus yang seharusnya hanya melindungi satu route.

FAQ

Apakah middleware per route bisa lebih dari satu?

Bisa, tulis berurutan atau dalam array seperti [cekAuth, validasiInput].

Apa beda middleware per route dan app.use?

Middleware per route hanya jalan di endpoint itu, sedangkan app.use jalan di semua request berikutnya.

Kenapa req.body kosong di dalam middleware per route?

Umumnya karena express.json() belum dipasang sebelum route tersebut.