Server sebagai fungsi: request masuk, respons keluar

Server web menunggu permintaan dan menjawab setiap permintaan dengan satu respons. Di Node.js, server dibuat dengan createServer dari modul node:http. Fungsi yang diberikan ke createServer disebut request handler; panduan Anatomy of an HTTP Transaction di nodejs.org mencatat fungsi itu dipanggil sekali untuk setiap permintaan, dengan objek request untuk membaca permintaan dan objek response untuk menulis jawaban. Aplikasi Node.js berjalan dalam satu proses, dan selama menunggu disk atau jaringan ia melayani permintaan lain.

import { createServer } from "node:http";

createServer((request, response) => {
  // request.method  → "GET"
  // request.url     → "/menu?cabang=solo" (path beserta query)
  // request.headers → { "user-agent": "...", accept: "..." }, nama huruf kecil
  response.statusCode = 200;
  response.setHeader("Content-Type", "application/json");
  response.end(JSON.stringify({ cabang: "solo", buka: true }));
}).listen(3000);

Dokumentasi API Node.js menyatakan nama header di request.headers selalu huruf kecil, apa pun bentuk yang dikirim klien, sehingga Content-Type dibaca sebagai headers["content-type"]. statusCode bernilai 200 bila tidak diubah, setHeader memasang header, dan end mengirim badan sekaligus menutup respons. Respons yang tidak pernah diakhiri membuat klien menunggu sampai batas waktunya habis.

Kelas ini memakai bentuk yang mudah diuji: handler adalah fungsi biasa handler(req) yang mengembalikan objek { status, headers, body }. Request tiruan berisi method, path, query, headers, dan body (teks mentah). Di aplikasi sungguhan, beberapa baris penghubung mengubah request Node menjadi req, memanggil handler, lalu menulis hasilnya dengan writeHead dan end. Karena handler tidak menyentuh port atau jaringan, setiap latihan menjalankannya langsung di browser-mu.

function json(status, data, headers = {}) {
  return { status, headers: { "content-type": "application/json", ...headers }, body: data };
}

json(200, { cabang: "solo", buka: true });
// → { status: 200, headers: { "content-type": "application/json" }, body: { cabang: "solo", buka: true } }