Express bevezetés

1Mi az Express?

Az Express a Node.js legelterjedtebb webes keretrendszere. Nem cseréli le a beépített http modult — ráépül: ugyanaz a szerver fut alatta, csak kényelmesebb felülettel.

Egy mondatban: az Express a kérés-válasz kezelés kényelmi rétege.

Mit ad?

Mit NEM ad?

Ezt legalább ilyen fontos tudni — az Express szándékosan minimalista:

2Telepítés

Az Express npm-csomag, tehát a projektbe telepítjük:

mkdir express-proba
cd express-proba
npm init -y
npm install express

Ellenőrzés — a package.json kiegészült:

{
  "name": "express-proba",
  "version": "1.0.0",
  "type": "module",
  "main": "index.js",
  "dependencies": {
    "express": "^5.2.1"
  }
}

A telepített verzió: Express 5.2.1. A csomag Node 18-as vagy újabb verziót igényel — a mi Node 24-esünk bőven megfelel.

3Az első Express-alkalmazás

import express from "express";              // 1

const app = express();                      // 2

app.get("/", (req, res) => {                // 3
  res.send("Szia az Expressről!");          // 4
});

app.listen(3000, () => {                    // 5
  console.log("A szerver fut: http://localhost:3000");
});

Indítás:

node --watch index.js

Sorról sorra

Mi történik az app.listen() mögött?

Ez a sor a háttérben pontosan ezt csinálja:

// amit az app.listen(3000) valójában tesz:
import http from "node:http";
const server = http.createServer(app);   // az app maga a kérés-feldolgozó függvény!
server.listen(3000);

Az app egy függvény, amely (req, res) paramétereket vár — pontosan olyan, mint amit a http.createServer() elvár. Az Express tehát nem helyettesíti a Node szerverét, hanem kiszolgáló függvényt ad neki.

4A válaszküldés eszközei

Az Express négy metódust ad, amit naponta használni fogsz. A Content-Type fejlécet mindegyik automatikusan beállítja — de nem mindegy, melyiket választod.

A tényleges viselkedés

Ezek valódi, kipróbált válaszok (Express 5.2.1):

Figyeld meg a táblázat két meglepetését. Az egyik, hogy a szám és a tömb is JSON-ként megy el — csak a szöveg az, ami HTML-nek számít. A másik, hogy a res.sendStatus(404) az angol Not Found szöveget küldi törzsként, sima szövegként — ez API-ban nem az, amit a kliens vár.

res.status(404).json({ error: { message: "Nincs ilyen termék." } });

A státuszkód mindig a küldés ELŐTT

res.status(201).json(termek);      // ✅ helyes — láncolva
res.json(termek).status(201);      // ❌ hiába: a válasz már elment

A res.status() csak beállít, nem küld. A tényleges küldés a json() / send() hívásnál történik — utána már késő módosítani.

5Express 4 vs. 5 — amit tudnod kell

Ez a szakasz meg fogja spórolni neked az első órák felét. Az interneten és a régebbi könyvekben található példák szinte kivétel nélkül Express 4-esek, és néhány dolog az 5-ösben hibát dob.

A leggyakoribb csapda: a joker (*) útvonal

Rengeteg tutorial így írja a 404-kezelőt:

app.get("*", (req, res) => {          // ❌ Express 5-ben HIBA!
  res.status(404).send("Nincs ilyen oldal");
});

Express 5-ben ez azonnal elszáll, már induláskor — a szerver el sem indul:

PathError [TypeError]: Missing parameter name at index 1: *; visit https://git.new/pathToRegexpError for info
    at consumeUntil (…\node_modules\path-to-regexp\dist\index.js:108:27)
    …
  originalPath: '*'

Miért? Mert az 5-ös verzió új útvonal-értelmezőt használ, amelyben a * önmagában nem érvényes: minden jokernek nevet kell adni.

A helyes megoldás — kétféleképpen:

// 1) Útvonal nélküli middleware a lánc VÉGÉN — ez a legegyszerűbb
app.use((req, res) => {
  res.status(404).json({ error: { message: "Nincs ilyen végpont." } });
});

// 2) Nevesített joker, ha tényleg kell az útvonal
app.get("/{*barmi}", (req, res) => {
  res.status(404).json({ error: { message: "Nincs ilyen végpont." } });
});

A 404-kezelő helye (a lánc legvégén) a 8. fejezet témája — itt csak a szintaxis a lényeg. Az útvonalminták teljes Express 5-ös szabályrendszere pedig a következő fejezetben jön.

Ugyanaz a kód régen és most

app.del("/api/products/:id", (req, res) => {
  const id = req.param("id");
  res.json(204, { torolve: id });
});

app.get("*", (req, res) =>
  res.status(404).send("Nincs ilyen"));

app.delete("/api/products/:id", (req, res) => {
  const id = req.params.id;
  res.sendStatus(204);
});

app.use((req, res) =>
  res.status(404).json(
    { error: { message: "Nincs ilyen végpont." } }));

Négy változás egyetlen példában: app.del → app.delete, req.param() → req.params.id, res.json(kód, obj) → külön hívás, és a joker helyett app.use(). Vedd észre azt is, hogy a 204 mellé nem küldünk törzset — a 204 épp azt jelenti, hogy nincs tartalom.

Egyéb eltérések

Az aszinkron hibák — a legjobb újdonság

Express 4-ben ez a kód csendben elszállt, és a kérés örökre lógott:

app.get("/api/products", async (req, res) => {
  const termekek = await adatbazisbolLekerdez();   // ha ez hibát dob…
  res.json(termekek);
});

Express 5-ben a keretrendszer elkapja, és továbbadja a hibakezelőnek. Ellenőrizve: egy szándékosan dobott hiba az async útvonalban eljut a hibakezelő middleware-hez, és 500-as válasz születik belőle:

GET /hiba  →  500  application/json  {"error":"szandekos hiba"}

6Projektszerkezet: app.js és index.js

Eddig egyetlen fájlban volt minden. Már most érdemes kettéválasztani:

// app.js — az alkalmazás FELÉPÍTÉSE
import express from "express";

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

app.get("/", (req, res) => {
  res.json({ uzenet: "Szia az Expressről!" });
});

export default app;   // NEM indítjuk el

// index.js — a szerver INDÍTÁSA
import app from "./app.js";

const PORT = process.env.PORT || 3000;

app.listen(PORT, () => {
  console.log(
    `A szerver fut: http://localhost:${PORT}`);
});

Miért érdemes szétválasztani?

7A port és a környezeti változók

const PORT = process.env.PORT || 3000;

Használat .env fájllal (1. blokk, 3. fejezet):

# .env
PORT=4000

"scripts": {
  "dev": "node --watch --env-file=.env index.js"
}

8Gyakori hibák

9Feladatok

app.del("/api/products/:id", (req, res) => {
  const id = req.param("id");
  res.json(204, { torolve: id });
});

app.get("*", (req, res) => res.status(404).send("Nincs ilyen"));

10Önellenőrző kvíz

11Összegzés

12Fogalomtár