VinokurovVE/bun-server-test

Fork 0

Files

VinokurovVE faea4e4d1f Initial commit: Bun web server with middleware, routing, and comprehensive documentation

2025-12-11 23:56:40 +09:00

7.2 KiB

Raw Permalink Blame History

📋 Шпаргалка по встроенным возможностям Bun

⚡ Быстрые примеры

1️⃣ HTML рендер (Template Literals)

const html = `
  <!DOCTYPE html>
  <html>
    <body>
      <h1>${title}</h1>
      <p>${content}</p>
    </body>
  </html>
`;
return new Response(html, { headers: { "Content-Type": "text/html" } });

Скорость: 0.1ms | Когда: 80% случаев

2️⃣ JSON API

const data = { status: "ok", items: [] };
return new Response(JSON.stringify(data), {
  headers: { "Content-Type": "application/json" }
});

Встроено: V8 оптимизация | Когда: API endpoints

3️⃣ Статические файлы

return new Response(Bun.file("static/style.css"));

Скорость: 0.05ms | Когда: CSS, JS, медиа

4️⃣ Динамический контент

const items = ["A", "B", "C"];
const html = `
  <ul>
    ${items.map(i => `<li>${i}</li>`).join("")}
  </ul>
`;

Когда: Списки, таблицы

5️⃣ React компонент (SSR)

import React from "react";

const Page = ({ title }) => (
  <html>
    <body>
      <h1>{title}</h1>
    </body>
  </html>
);

const html = React.renderToString(<Page title="Hello" />);
return new Response(html, { headers: { "Content-Type": "text/html" } });

Скорость: 2-5ms | Когда: 15% случаев

6️⃣ Streaming большого файла

return new Response(Bun.file("large-file.zip"));
// или
const readable = new ReadableStream({ /* ... */ });
return new Response(readable);

Скорость: 0.05ms | Когда: Большие файлы

7️⃣ Кеширование

return new Response(html, {
  headers: {
    "Cache-Control": "public, max-age=3600",
    "ETag": '"123456"'
  }
});

Когда: Статические ассеты

// Установка
return new Response(html, {
  headers: {
    "Set-Cookie": "session=abc123; Path=/; HttpOnly"
  }
});

// Чтение
const cookie = req.headers.get("cookie");

9️⃣ TypeScript (встроенный)

const greeting: string = "Hello";
const numbers: number[] = [1, 2, 3];
interface User { name: string; age: number; }

Компиляция: встроенная | Конфигурация: опциональна

🔟 Web Standards API

const req = new Request("http://example.com");
const res = new Response("content");
const headers = new Headers({ "Content-Type": "text/html" });
const url = new URL("https://example.com");
const params = new URLSearchParams("a=1");
const blob = new Blob(["data"]);

🎯 Таблица выбора

Нужно что делать?              Используйте это
─────────────────────────────────────────────────────
HTML страница                  Template Literals
API endpoint (JSON)            JSON.stringify
Статический файл               Bun.file()
Большой файл                   Streaming API
React компонент                React.renderToString
Переиспользуемая логика        Custom функция
Типизация                      TypeScript
Кеширование браузером          Cache-Control
Сохранить состояние            Cookie

📊 Производительность

Template Literals      0.1ms   ⚡⚡⚡ ИСПОЛЬЗУЙТЕ
Bun.file()            0.05ms   ⚡⚡⚡ ДЛЯ ФАЙЛОВ
Streaming             0.05ms   ⚡⚡⚡ БОЛЬШИЕ
JSON.stringify()      встроено ⚡⚡⚡ ОПТИМИЗИРОВАН
React SSR             2-5ms    ⚡ КОГДА НУЖНЫ

🚀 Структура сервера

// 1. Импорты
import { Server } from "./server";
import { Router } from "./router";

// 2. Создание сервера
const server = new Server({ port: 3000 });
const router = server.getRouter();

// 3. Регистрация маршрутов
router.get("/", async (req, url) => {
  const html = `<!DOCTYPE html>...`;
  return new Response(html, { headers: { "Content-Type": "text/html" } });
});

router.get("/api/data", async (req, url) => {
  const data = { status: "ok" };
  return new Response(JSON.stringify(data), {
    headers: { "Content-Type": "application/json" }
  });
});

// 4. Запуск
server.start();

🎓 Правила для начинающих

Template Literals в 80% случаев
```
const html = `<h1>${title}</h1>`;
```

JSON.stringify для API

return new Response(JSON.stringify(data));

Bun.file для статики

return new Response(Bun.file("static/style.css"));

React только когда нужны компоненты

// NOT в 80% случаев - используйте Template Literals!

TypeScript для типизации

function handler(req: Request): Response { }

📦 Не требует установки

❌ НЕ нужно устанавливать:
- HTML рендер библиотеку
- Шаблонизатор
- HTTP сервер
- TypeScript компилятор
- JSON библиотеку

✅ ВСЕ встроено в Bun!

💡 Советы производительности

Кешируйте статику

"Cache-Control": "public, max-age=86400"

Используйте Streaming для больших файлов
```
return new Response(Bun.file("huge-file.zip"));
```

Делайте Template Literals чистыми

// ХОРОШО
const html = `<h1>${htmlEscape(title)}</h1>`;

// ПЛОХО
const html = "<h1>" + title + "</h1>";

Минифицируйте JSON если нужно

JSON.stringify(data)  // Компактный
// vs
JSON.stringify(data, null, 2)  // С отступами (для debug)

Используйте ETag для кеширования
```
"ETag": '"hash-of-content"'
```

🔗 Документация в проекте

WHAT_BUN_CAN_DO.md - Главный файл (начните отсюда!)
BUN_CAPABILITIES.md - 10 возможностей
BUN_RENDERING.md - Подробное руководство
README.md - Полная документация
DOCS_INDEX.md - Индекс всего

🎉 Итого

Bun имеет всё что нужно для веб-разработки БЕЗ дополнительных библиотек!

Используйте эту шпаргалку как быструю справку. Для деталей смотрите основные файлы документации.

Happy Bun coding! 🚀

7.2 KiB Raw Permalink Blame History Unescape Escape