Тесты — JS: Express

Supertest

Superagent
Функциональное тестирование — это тестирование ПО в целях проверки реализуемости функциональных требований, то есть способности ПО в определённых условиях решать задачи, нужные пользователям.

В отношении сайтов такое тестирование можно провести, делая HTTP-запросы к соответствующим обработчикам и проверяя их ответ. Чтобы это было возможно, требуется небольшая дисциплина кода. В случае Express она выражается в том, что определение приложения отделяется от его запуска.

// src/app.js
import Express from 'express';

const app = new Express();
app.get('/', (req, res) => res.send('hello'));
export default app;

// bin/app.js
#!/usr/bin/env node

import app from '../src/app.js';
app.listen(4000);

Такое разделение позволяет библиотекам для тестирования самостоятельно запускать приложение и останавливать его при выполнении запросов. Что, в свою очередь, позволяет легко этими тестами управлять. Вам не придётся следить за тем, чтобы поднять сервер или выключить, вы просто будете запускать тесты и проверять результат.

Supertest

Supertest — это библиотека, созданная исключительно с целью проводить функциональное тестирование HTTP-интерфейса.

// __tests__/app.test.js
import request from 'supertest';
import app from '../src/app.js';

test('request', async () => {
  const res = await request(app).get('/');
  if (res.error) {
    throw res.error;
  }
  expect(res.status).toBe(200);
});

После выполнения запроса она возвращает response, который содержит параметры ответа, а также объект error, в случае если произошла ошибка. Все тесты этого курса написаны с помощью данной библиотеки. При этом важно отметить, что эта библиотека не позволяет проверить генерируемый HTML, поэтому возможны ситуации, при которых ваш HTTP-интерфейс работает, а формы на сайте сделаны неправильно, что означает невозможность использования сайта. На данном этапе в бой вступает приёмочное тестирование, которое не рассматривается в рамках данного курса.

Superagent

В основе библиотеки Supertest лежит другая библиотека - Superagent. Именно она позволяет формировать произвольные запросы к серверу.

import request from 'superagent';

const res = await request
   .post('/api/pet')
   .type('form')
   .send({ name: 'Manny', species: 'cat' })
   .set('X-API-Key', 'foobar')
   .set('Accept', 'application/json');