Перейти к содержимому

Создание HTTP-сервиса

Обслуживание HTTP в Elide через fetch-обработчик или node:http: маршрутизация, JSON-тела, потоковая передача, статические файлы, TLS, несколько контекстов и фреймворки.

На этой странице

Elide обслуживает HTTP через fetch-обработчик или через node:http; на этой странице один и тот же сервис построен обоими способами.

Два способа обслуживания

Fetch-обработчикnode:http
Точка входаexport default { fetch } или Elide.serve({ fetch })http.createServer(listener).listen(port)
Запрос и ответВеб-объекты Request, ResponseIncomingMessage, ServerResponse
HTTPS и HTTP/2Параметры cert и keyНедоступно
--contextsДаНет; вторая копия завершается ошибкой EADDRINUSE
// server.ts
export default {
  port: Number(process.env.PORT ?? 3000),
  fetch(request: Request): Response {
    return new Response("hello\n");
  },
};
// node-server.ts
import { createServer } from "node:http";

const port = Number(process.env.PORT ?? 3000);

createServer((req, res) => {
  res.writeHead(200, { "content-type": "text/plain" });
  res.end("hello\n");
}).listen(port, "127.0.0.1");
elide run server.ts
curl -i http://127.0.0.1:3000/
HTTP/1.1 200 OK
Content-Type: text/plain;charset=UTF-8
content-length: 6
server: elide
date: Sat, 10 Oct 2026 00:18:12 GMT

hello

elide run node-server.ts отвечает на тот же запрос с Transfer-Encoding: chunked и Connection: keep-alive.

К какому адресу привязывается каждый вариант, если адрес не указан:

СерверАдрес по умолчанию
export default { fetch } под elide run127.0.0.1:8080
export default { fetch } под elide serve / elide dev127.0.0.1:8080 / 127.0.0.1:3000; --host и --port его переопределяют
Elide.serve({ port, fetch })0.0.0.0 на port

Маршруты, JSON и потоковая передача

URLPattern, Request.json(), Response.json() и тела ReadableStream доступны глобально. У этого сервера есть API, потоковый ответ и статические файлы из public/:

// app.ts
import { readFile } from "node:fs/promises";
import { extname, join, normalize } from "node:path";

const users = new URLPattern({ pathname: "/api/users/:id" });
const types: Record<string, string> = {
  ".html": "text/html; charset=utf-8",
  ".css": "text/css",
  ".js": "text/javascript",
};

async function api(request: Request): Promise<Response | null> {
  const url = new URL(request.url);
  const match = users.exec(url);
  if (match && request.method === "GET") {
    return Response.json({ id: match.pathname.groups.id });
  }
  if (url.pathname === "/api/users" && request.method === "POST") {
    const body = await request.json();
    return Response.json({ created: body.name }, { status: 201 });
  }
  if (url.pathname === "/api/ticks") {
    let n = 0;
    const stream = new ReadableStream({
      async pull(controller) {
        controller.enqueue(new TextEncoder().encode(`tick ${++n}\n`));
        await new Promise((r) => setTimeout(r, 200));
        if (n === 3) controller.close();
      },
    });
    return new Response(stream, { headers: { "content-type": "text/plain" } });
  }
  return null;
}

async function file(pathname: string): Promise<Response> {
  const path = join("public", normalize(pathname === "/" ? "/index.html" : pathname));
  try {
    const body = await readFile(path);
    return new Response(body, { headers: { "content-type": types[extname(path)] ?? "application/octet-stream" } });
  } catch {
    return new Response("not found\n", { status: 404 });
  }
}

export default {
  port: Number(process.env.PORT ?? 3000),
  async fetch(request: Request): Promise<Response> {
    return (await api(request)) ?? file(new URL(request.url).pathname);
  },
};
elide run app.ts
curl http://127.0.0.1:3000/api/users/42
curl -X POST -H 'content-type: application/json' -d '{"name":"ada"}' http://127.0.0.1:3000/api/users
curl -N http://127.0.0.1:3000/api/ticks
{"id":"42"}
{"created":"ada"}
tick 1
tick 2
tick 3

POST отвечает 201 Created. Три тика приходят с интервалом 200 мс. / возвращает public/index.html, а отсутствующий файл — 404.

Тот же API на node:http читает тело через node:stream/consumers и передаёт поток через res.write:

// node-app.ts
import { createServer } from "node:http";
import { text } from "node:stream/consumers";

createServer(async (req, res) => {
  if (req.method === "POST" && req.url === "/api/users") {
    const body = JSON.parse(await text(req));
    res.writeHead(201, { "content-type": "application/json" });
    res.end(JSON.stringify({ created: body.name }));
    return;
  }
  if (req.url === "/api/ticks") {
    res.writeHead(200, { "content-type": "text/plain" });
    for (let n = 1; n <= 3; n++) {
      res.write(`tick ${n}\n`);
      await new Promise((r) => setTimeout(r, 200));
    }
    res.end();
    return;
  }
  res.writeHead(404).end();
}).listen(Number(process.env.PORT ?? 3000), "127.0.0.1");

Чтобы раздавать только файлы, используйте elide serve ./public; см. Сервер разработки.

Ошибки

Fetch-обработчик, который выбрасывает исключение или возвращает отклонённый промис, отвечает 500 Internal Server Error и продолжает работать. Ошибка не выводится, поэтому перехватывайте и записывайте её сами:

curl -i -d 'not json' http://127.0.0.1:3000/api/users
HTTP/1.1 500 Internal Server Error
Content-Type: text/plain; charset=utf-8
content-length: 21
server: elide
date: Sat, 10 Oct 2026 00:34:28 GMT

Internal Server Error

TLS

Передайте строки PEM как cert и key в Elide.serve или как свойства экспортируемого объекта. Ключ должен быть в формате PKCS#8 без шифрования (BEGIN PRIVATE KEY). Клиенты, которые предлагают HTTP/2, получают его.

// tls.ts
import { readFileSync } from "node:fs";

Elide.serve({
  port: Number(process.env.PORT ?? 8443),
  cert: readFileSync("cert.pem", "utf8"),
  key: readFileSync("key.pem", "utf8"),
  fetch(request) {
    return new Response("hello over tls\n");
  },
});
elide run tls.ts
curl -i --cacert cert.pem https://localhost:8443/
HTTP/2 200
content-type: text/plain;charset=UTF-8
content-length: 15
server: elide
date: Sat, 10 Oct 2026 00:18:52 GMT

hello over tls

У elide serve и elide dev нет флагов TLS, а в elide.pkl нет настроек TLS. https.createServer выбрасывает:

Error: HTTPS server is not supported in this runtime (no host TLS listener); use http.createServer behind a TLS terminator, or https client APIs.

Несколько контекстов

--contexts=N запускает N копий приложения с fetch-обработчиком на одном порту, в Linux. У каждой копии своё состояние модулей:

// counter.ts
let count = 0;

export default {
  fetch(): Response {
    count += 1;
    return new Response(`${count}\n`);
  },
};
elide serve --no-tui --contexts=4 counter.ts
for i in 1 2 3 4 5 6 7 8; do curl -s http://127.0.0.1:8080/; done
1
1
2
2
3
4
1
2

Храните общее состояние в базе данных или другом сервисе. --contexts=auto выбирает число по ядрам CPU; engine.contexts в elide.pkl задаёт его для проекта (Контексты движка).

Фреймворки

Установите их командой elide install --ecosystems=npm.

ФреймворкСтатус
HonoРаботает: export default { fetch: app.fetch } или export default app.
Express 5Маршрутизация, res.json, express.raw() и ручное чтение req работают. express.json() и express.text() останавливают процесс с TypeError: Buffer.isBuffer is not a function.
Fastify 5Ошибка при импорте: Error: No such built-in module: node:http2.
// hono-app.ts
import { Hono } from "hono";

const app = new Hono();
app.get("/users/:id", (c) => c.json({ id: c.req.param("id") }));
app.post("/users", async (c) => c.json({ created: (await c.req.json()).name }, 201));

export default {
  port: Number(process.env.PORT ?? 3000),
  fetch: app.fetch,
};

Примеры

Что дальше

Была ли эта страница полезной?