HTTP Server Node.js: http.createServer dengan Contoh

http.createServer() membuat web server dari satu fungsi, yaitu request handler, yang dipanggil Node untuk setiap request yang masuk dengan dua object: req (method, URL, dan header yang dikirim client) dan res (apa yang kamu kirim balik). Atur status code dan header di res, lalu panggil res.end() dengan body-nya. server.listen(3000) mulai menerima koneksi di port 3000.

const http = require('http');

const server = http.createServer((req, res) => {
    console.log(req.method, req.url);
    res.statusCode = 200;
    res.setHeader('Content-Type', 'text/plain');
    res.end(`You asked for ${req.method} ${req.url}`);
});

// GET /hello?name=Ada
server.listen(3000, () => {
    console.log('Listening on port 3000');
});

Request pertama menjawab You asked for GET /hello?name=Ada, dan Console mencatat method dan URL yang sama. Kirim DELETE /anything dari request bar: handler yang sama menjawabnya, karena server http polos tidak punya route. Setiap request melewati satu fungsi itu.

Mengirim JSON dan mengatur status code

res.writeHead(status, headers) mengatur status code dan header dalam satu panggilan. Untuk JSON, atur Content-Type: application/json dan kirim hasil JSON.stringify(); res.end() hanya menerima string atau Buffer.

const http = require('http');

const users = [
    { id: 1, name: 'Ada' },
    { id: 2, name: 'Linus' },
];

function sendJson(res, status, data) {
    res.writeHead(status, { 'Content-Type': 'application/json' });
    res.end(JSON.stringify(data));
}

const server = http.createServer((req, res) => {
    const url = new URL(req.url, 'http://localhost');
    const limit = Number(url.searchParams.get('limit')) || users.length;

    if (req.method === 'GET' && url.pathname === '/users') {
        return sendJson(res, 200, users.slice(0, limit));
    }
    sendJson(res, 404, { error: 'Not found' });
});

// GET /users?limit=1
server.listen(3000);

GET /users?limit=1 mengembalikan [{"id":1,"name":"Ada"}]. req.url adalah path ditambah query string, jadi new URL(req.url, 'http://localhost') memecahnya menjadi pathname dan searchParams (base-nya ada hanya karena URL butuh alamat absolut). Kirim GET /nothing dan status-nya berubah menjadi 404.

Routing request dengan switch

API kecil tidak butuh lebih dari switch pada method dan path. Susun kunci seperti 'GET /users' dan beri setiap route case-nya sendiri:

const http = require('http');

const users = [{ id: 1, name: 'Ada' }];

function sendJson(res, status, data) {
    res.writeHead(status, { 'Content-Type': 'application/json' });
    res.end(JSON.stringify(data));
}

function readBody(req) {
    return new Promise((resolve, reject) => {
        let data = '';
        req.on('data', (chunk) => {
            data += chunk;
        });
        req.on('end', () => resolve(data));
        req.on('error', reject);
    });
}

const server = http.createServer(async (req, res) => {
    const { pathname } = new URL(req.url, 'http://localhost');

    switch (`${req.method} ${pathname}`) {
        case 'GET /users':
            return sendJson(res, 200, users);

        case 'POST /users': {
            let body;
            try {
                body = JSON.parse(await readBody(req));
            } catch {
                return sendJson(res, 400, { error: 'Body must be JSON' });
            }
            const user = { id: users.length + 1, name: body.name };
            users.push(user);
            return sendJson(res, 201, user);
        }

        default:
            sendJson(res, 404, { error: `No route for ${req.method} ${pathname}` });
    }
});

// GET /users
server.listen(3000);

Kirim POST /users dengan body {"name": "Grace"}: jawabannya 201 dengan {"id":2,"name":"Grace"}, dan GET /users sekarang menampilkan kedua user. Kirim POST yang sama dengan body hello dan kamu mendapat 400 dengan {"error":"Body must be JSON"}.

Membaca body POST

Node tidak mem-parse body untukmu. req adalah readable stream, dan body-nya tiba dalam potongan lewat event data, lalu end terpancar setelah lengkap. readBody() di atas mengumpulkan potongan-potongannya menjadi string dan mengembalikan promise, jadi handler bisa meng-await-nya. Karena req adalah async iterable, perulangan ini melakukan pekerjaan yang sama:

let data = '';
for await (const chunk of req) data += chunk;
const body = JSON.parse(data);

Server sungguhan juga membatasi ukurannya (berhenti membaca dan menjawab 413 saat data.length melewati batas) dan mengecek req.headers['content-type'] sebelum memanggil JSON.parse.

Kesalahan umum

Lupa res.end(). Cabang yang mengatur status tetapi tidak pernah mengakhiri response membuat client menunggu sampai timeout.

Mengatur header setelah body. Begitu res.end() atau res.write() pertama sudah berjalan, header-nya sudah terkirim, dan res.setHeader() melempar ERR_HTTP_HEADERS_SENT. Pakai return saat kamu mengirim response lebih awal, seperti di contoh-contohnya.

Membandingkan req.url dengan path. req.url menyertakan query string, jadi req.url === '/users' bernilai false untuk /users?limit=1. Bandingkan pathname.

Kapan memakai Express

Module http sudah cukup untuk health check, penerima webhook, atau mempelajari cara kerja HTTP. Begitu kamu butuh parameter route seperti /users/:id, parsing body JSON, middleware, dan penanganan error, kamu akhirnya menulis framework kecilmu sendiri. Express adalah framework itu, dibangun di atas object req dan res yang sama; routing Express menunjukkan API yang sama dengan app.get() dan app.post().