Какие инструменты используются для написания HTTP-тестов (например, supertest)?

HTTP-тесты проверяют, что сервер корректно обрабатывает запросы: возвращает нужные статусы, заголовки и тело. В отличие от юнит-тестов, здесь поднимается реальное приложение (или его часть) и к нему отправляются настоящие HTTP-запросы. Это ловит ошибки маршрутизации, валидации, middleware и сериализации, которые юнит-тесты пропускают.

Основные инструменты

• supertest — самая популярная библиотека для Node.js: принимает Express/Nest/Koa приложение и предоставляет fluent API для запросов и ассертов.
• Jest / Mocha / Vitest — тест-раннеры, которые запускают тесты, дают describe/it, моки и отчёты.
• nock — перехватывает исходящие HTTP-запросы, чтобы мокать внешние сервисы.
• Pact — контрактное тестирование между сервисами.
• Postman / Newman — e2e-сценарии и запуск коллекций в CI.

Пример с supertest и Jest

const request = require('supertest');
const app = require('../app'); // Express-приложение

describe('GET /users/:id', () => {
  it('возвращает пользователя', async () => {
    const res = await request(app)
      .get('/users/1')
      .set('Accept', 'application/json');

    expect(res.status).toBe(200);
    expect(res.body).toEqual({ id: 1, name: 'Alice' });
  });

  it('404 для несуществующего', async () => {
    const res = await request(app).get('/users/999');
    expect(res.status).toBe(404);
  });
});

Как это работает

1. Supertest поднимает приложение на случайном порту (или использует in-memory).
2. Отправляет реальный HTTP-запрос через http-модуль Node.
3. Возвращает объект ответа со status, headers, body.
4. Ассерты Jest проверяют ожидаемое поведение.

Для внешних зависимостей (платёжки, сторонние API) используют nock или DI-моки, чтобы тесты были быстрыми и детерминированными. В CI такие тесты запускаются после юнит-тестов и перед e2e.

Итог: supertest в связке с Jest — стандарт для HTTP-тестов Node.js API; применяйте его для проверки маршрутов, валидации и кодов ответа, а nock и Pact — когда нужно изолировать внешние сервисы.