Elide обслуживает HTTP через fetch-обработчик или через node:http; на этой странице один и тот же сервис построен
обоими способами.
Два способа обслуживания
| Fetch-обработчик | node:http | |
|---|---|---|
| Точка входа | export default { fetch } или Elide.serve({ fetch }) | http. |
| Запрос и ответ | Веб-объекты Request, Response | IncomingMessage, 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
helloelide run node-server.ts отвечает на тот же запрос с Transfer-Encoding: chunked и Connection: keep-alive.
К какому адресу привязывается каждый вариант, если адрес не указан:
| Сервер | Адрес по умолчанию |
|---|---|
export default { fetch } под elide run | 127.0.0.1:8080 |
export default { fetch } под elide serve / elide dev | 127.0.0.1:8080 / 127.0.0.1:3000; --host и --port его переопределяют |
Elide. | 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 3POST отвечает 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/usersHTTP/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 ErrorTLS
Передайте строки 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/; done1
1
2
2
3
4
1
2Храните общее состояние в базе данных или другом сервисе. --contexts=auto выбирает число по ядрам CPU;
engine.contexts в elide.pkl задаёт его для проекта (Контексты движка).
Фреймворки
Установите их командой elide install --ecosystems=npm.
| Фреймворк | Статус |
|---|---|
| Hono | Работает: export default { fetch: app. или export default app. |
| Express 5 | Маршрутизация, res.json, express.raw() и ручное чтение req работают. express.json() и express.text() останавливают процесс с TypeError: Buffer.. |
| 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,
};Примеры
- HTTP-обработчик
- Маршруты с URLPattern
- Локальный сервер и fetch
- Server-sent events
- Ограничения запросов
- Сервер с несколькими контекстами