Membuat middleware sederhana dengan Express JS

 

Dalam pengembangan aplikasi backend menggunakan Node.js, Express.js menjadi salah satu framework yang paling populer karena kesederhanaan dan fleksibilitasnya. Salah satu fitur paling penting dalam Express adalah middleware. Dengan memahami konsep middleware, kita dapat mengontrol alur request–response, melakukan validasi, logging, autentikasi, dan berbagai fungsi lainnya dengan cara yang lebih terstruktur. Pada artikel ini, kita akan membahas apa itu middleware, bagaimana cara membuatnya, dan contoh penerapannya pada aplikasi Express.js sederhana.

 

Apa Itu Middleware?

Secara sederhana, middleware adalah fungsi yang dieksekusi di antara request dari client dan response yang akan dikirimkan server. Middleware dapat memodifikasi objek request (req) dan response (res), menjalankan logika tertentu, atau menghentikan proses sebelum mencapai handler utama. Setiap middleware memiliki parameter standar:

• req: objek yang berisi informasi request.

• res: objek untuk mengirimkan response.

• next: fungsi yang dipanggil untuk melanjutkan ke middleware berikutnya.

Struktur dasarnya seperti ini:

 

function middleware(req, res, next) {

// logika middleware

next(); // melanjutkan ke middleware berikutnya

}

Ketika next() tidak dipanggil, maka request akan berhenti di middleware tersebut. Hal ini berguna jika kita ingin memblokir akses atau mengirimkan response langsung dari middleware.

 

Persiapan Project Express

Sebelum membuat middleware, mari siapkan project Express.js sederhana. Jalankan perintah berikut pada lokasi project kalian:

npm init -y
npm install express
 

Lalu buat file server.js

const express = require('express');

const app = express();

const port = 3000;

Membuat Middleware Logging Sederhana

Salah satu contoh middleware yang umum dipakai adalah middleware logging. Tujuannya adalah mencatat setiap request yang masuk, lengkap dengan method, URL, dan waktu aksesnya.

Contohnya:

const logger = (req, res, next) => {

const time = new Date().toLocaleString();

console.log('ini middleware logger')

console.log(`[${time}] ${req.method} ${req.url}`);

next();

};

Middleware ini memudahkan developer melihat aktivitas request pada server dan sangat berguna untuk debugging maupun monitoring.

Untuk menggunakannya, cukup daftarkan di Express: 

app.use(logger);

Setiap request menuju endpoint mana pun akan melalui middleware logger terlebih dahulu.

Menambahkan Route untuk Pengujian

Tambahkan route sederhana agar kita bisa melihat middleware bekerja:

app.get('/', (req, res) => {

res.send('Halo, ini homepage!');

});

Kemudian jalankan server:

app.listen(port, () => {

console.log(`Server berjalan di http://localhost:${port}`);

});

Buka terminal arahkan ke route project kalian tersimpan, lalu ketikan "node server.js" tanpa tanda kutip,

Saat mengakses http://localhost:3000/, console akan menampilkan log seperti:

Server berjalan di http://localhost:3000

ini middleware logger

[11/14/2025, 9:46:58 AM] GET /

 

Middleware dengan Parameter (Dynamic Middleware)

Middleware juga bisa dibuat lebih fleksibel dengan parameter tambahan. Misalnya, kita membuat middleware untuk mengecek API key:

const checkApiKey = (key) => {

const oriKey='123';

return (req, res, next) => {

if (oriKey === key) {

next();

} else {

console.log(req.query)

res.status(401).send('API Key salah! ');

}

};

};  

Penggunaan:

app.get('/secure', checkApiKey('123'), (req, res) => {

res.send('Akses berhasil!');

});

Middleware seperti ini sangat berguna dalam implementasi autentikasi, pembatasan akses, ataupun proteksi endpoint tertentu.

Kesimpulan

Middleware adalah salah satu pilar utama dalam arsitektur Express.js. Dengan memahaminya, kita dapat membangun aplikasi yang lebih terstruktur, aman, dan mudah dikelola. Middleware memungkinkan kita menambahkan fungsi seperti logging, validasi, autentikasi, hingga error handling tanpa harus mengotori kode utama pada route handler.