Koa.js: детальний огляд з прикладами 📌

🔹 Що таке Koa.js?

Koa.js — це мінімалістичний та гнучкий фреймворк для Node.js, створений авторами Express.js. Його основна мета — забезпечити легкість та простоту, прибравши зайві обмеження та надаючи повний контроль над middleware.

Koa.js використовує асинхронні функції (async/await) для кращої обробки запитів та управління потоком виконання, що допомагає уникнути callback hell.

---

🔹 Головні особливості Koa.js

✅ Мінімалістичність

На відміну від Express.js, у Koa немає вбудованих роутерів, middleware або шаблонізаторів. Це дозволяє повністю контролювати стек технологій, додаючи лише необхідні компоненти.

✅ Сучасний підхід (async/await)

Koa.js використовує async/await замість старих callback-функцій або промісів, що робить код чистішим, зрозумілішим і легшим для відладки.

✅ Краща обробка помилок

Koa.js використовує try/catch для керування помилками, що зменшує кількість неочікуваних збоїв.

✅ Повний контроль над middleware

У Koa.js все працює через middleware, що забезпечує:

• Гнучкість у налаштуванні логіки запитів.
• Кращу керованість потоком виконання.

✅ Модульний підхід

Усі необхідні функції (наприклад, маршрутизація, аутентифікація, body-parsing) додаються через окремі бібліотеки, а не є вбудованими, як в Express.js.

---

🔹 Основи Koa.js

📌 Встановлення

Перед використанням потрібно встановити Koa через npm:

npm install koa

---

📌 Створення простого сервера

const Koa = require('koa');
const app = new Koa();

app.use(async (ctx) => {
  ctx.body = 'Привіт, Koa!';
});

app.listen(3000, () => {
  console.log('Сервер працює на http://localhost:3000');
});

📌 Що тут відбувається?

1. Імпортуємо Koa та створюємо новий екземпляр app.
2. Використовуємо app.use() для обробки HTTP-запиту.
3. ctx.body = 'Привіт, Koa!' встановлює відповідь сервера.
4. Запускаємо сервер на 3000 порту.

---

📌 Middleware у Koa.js

У Koa все є middleware. Це функції, які отримують контекст (ctx) та виконуються у вигляді ланцюжка викликів (middleware stack).

✅ Приклад кількох middleware

const Koa = require('koa');
const app = new Koa();

app.use(async (ctx, next) => {
  console.log('Перший middleware');
  await next();
  console.log('Перший middleware завершено');
});

app.use(async (ctx, next) => {
  console.log('Другий middleware');
  await next();
  console.log('Другий middleware завершено');
});

app.use(async (ctx) => {
  console.log('Останній middleware');
  ctx.body = 'Hello from Koa!';
});

app.listen(3000, () => {
  console.log('Сервер працює на http://localhost:3000');
});

📌 Як працює middleware в Koa?

1. Викликається перший middleware → console.log('Перший middleware').
2. Викликається next(), іде до другого middleware → console.log('Другий middleware').
3. Викликається next(), іде до останнього middleware → console.log('Останній middleware').
4. Встановлюється ctx.body.
5. Виконання йде у зворотному порядку, завершуючи перший та другий middleware.

---

📌 Обробка маршрутів (Routing)

Оскільки Koa.js не має вбудованої маршрутизації, треба встановити пакет koa-router:

npm install @koa/router

✅ Приклад роутера

const Koa = require('koa');
const Router = require('@koa/router');

const app = new Koa();
const router = new Router();

router.get('/', async (ctx) => {
  ctx.body = 'Головна сторінка';
});

router.get('/about', async (ctx) => {
  ctx.body = 'Сторінка "Про нас"';
});

app.use(router.routes()).use(router.allowedMethods());

app.listen(3000, () => {
  console.log('Сервер працює на http://localhost:3000');
});

📌 Що тут відбувається?

• Використовуємо koa-router для створення маршрутів.
• router.get('/about') відповідає за маршрут /about.
• app.use(router.routes()) підключає маршрути до додатку.

---

📌 Обробка JSON-запитів

За замовчуванням Koa.js не підтримує body-parsing, тому треба встановити koa-bodyparser:

npm install koa-bodyparser

✅ Обробка POST-запитів

const Koa = require('koa');
const Router = require('@koa/router');
const bodyParser = require('koa-bodyparser');

const app = new Koa();
const router = new Router();

app.use(bodyParser());

router.post('/data', async (ctx) => {
  const { name, age } = ctx.request.body;
  ctx.body = `Отримано: ${name}, ${age}`;
});

app.use(router.routes());

app.listen(3000, () => {
  console.log('Сервер працює на http://localhost:3000');
});

📌 Що тут відбувається?

• Використовуємо koa-bodyparser для розбору JSON.
• Маршрут /data приймає POST-запити.
• ctx.request.body містить передані дані.

---

🔹 Переваги Koa.js

✅ Мінімалістичний та швидкий – немає зайвих функцій.
✅ Чиста архітектура – все контролюється через middleware.
✅ Сучасний підхід (async/await) – код стає зрозумілішим.
✅ Краща обробка помилок – немає проблем з callback-hell.
✅ Гнучкість – можна використовувати лише необхідні модулі.

---

🔹 Недоліки Koa.js

❌ Має круту криву навчання – не такий простий, як Express.
❌ Потрібно встановлювати багато додаткових бібліотек (роутер, body-parser тощо).
❌ Маленька спільнота – порівняно з Express, менше готових рішень.

---

🔹 Для кого підходить Koa.js?

✅ Для досвідчених розробників, які хочуть більше контролю над кодом.
✅ Для високонавантажених проєктів, де важлива продуктивність.
✅ Для тих, кому потрібен мінімалістичний фреймворк без зайвого функціоналу.

---

🔹 Висновок

Koa.js – це сучасний, мінімалістичний та продуктивний фреймворк для Node.js, який дає повний контроль над запитами. Завдяки async/await, middleware-архітектурі та відсутності зайвого коду, він ідеально підходить для гнучких, високонавантажених додатків. Але якщо вам потрібен простий та готовий фреймворк, Express.js може бути кращим вибором. 🚀