@itd-api/testing

Сценарные ответы, сервер API в памяти, заготовки данных и управляемый realtime для тестирования itd-api без сетевых запросов.

Руководство · API из TSDoc

Установка

npm install itd-api
npm install --save-dev @itd-api/testing

Поддерживается itd-api >=0.5.0 <1.0.0.

Сервер с состоянием

import { ItdClient } from 'itd-api';
import { createMockServer } from '@itd-api/testing';

const server = createMockServer({
  seed: {
    users: [
      { id: 'user-alice', username: 'alice' },
      { id: 'user-bob', username: 'bob' },
    ],
  },
});

const alice = new ItdClient(server.clientOptions({ as: 'alice' }));
const bob = new ItdClient(server.clientOptions({ as: 'bob' }));

const post = await alice.posts.create({ content: 'Проверяем сценарий' });
await bob.posts.like(post.id);

expect((await alice.posts.get(post.id)).likesCount).toBe(1);

Оба клиента работают с одним состоянием. Сервер поддерживает профили, записи, комментарии и ответы, реакции, подписки, уведомления, удаление и восстановление. Неизвестный маршрут возвращает статус 501 с кодом MOCK_ROUTE_NOT_IMPLEMENTED. Некорректные связи и повторяющиеся идентификаторы в seed отклоняются до изменения состояния.

Сценарный fetch

import { ItdClient } from 'itd-api';
import { apiErrorResponse, apiResponse, createMockFetch, userFixture } from '@itd-api/testing';

const mock = createMockFetch();
mock.get('/api/users/me', [
  apiErrorResponse(503, 'TEMPORARY', 'Повторите запрос'),
  apiResponse(userFixture()),
]);

const itd = new ItdClient({ fetch: mock.fetch, auth: 'test-token' });
await itd.users.me();
mock.assertDone();

Маршруты принимают параметры вида /api/posts/:postId. Обработчик получает разобранные query-параметры, заголовки, JSON, FormData, текст и двоичное тело. История в mock.requests скрывает токены, cookie, пароли, OTP и Turnstile-токены. sseResponse() создаёт настоящий поток Server-Sent Events для проверки SSE-разбора.

Моки логических операций

Когда HTTP-детали не являются предметом теста, подменяйте стабильный operationId:

import { ItdClient } from 'itd-api';
import { createMockOperations, userFixture } from '@itd-api/testing';

const mock = createMockOperations().operation('users.me', userFixture({ username: 'alice' }));
const itd = new ItdClient({ auth: 'test-token' }).use(mock);

await itd.users.me();
mock.assertDone();

Такой mock завершает логическую операцию до retry, auth и transport. Для проверки 401, повторов, заголовков и сериализации по-прежнему используйте createMockFetch().

Управляемое время и realtime

import { createTestClock, MockRealtimeTransport } from '@itd-api/testing';

const clock = createTestClock('2026-08-01T10:00:00Z');
const transport = new MockRealtimeTransport();

const itd = new ItdClient({ auth: 'test-token', clock });
const stream = itd.realtime({ transport, syncCount: false, jitter: 0 });
await stream.connect();
await transport.waitForConnection(0);

transport.unreadCount(3);
await stream.drain();

await clock.advanceBy(1_000); // повторы, тайм-ауты и переподключение без реального ожидания

Подробнее: руководство по testing.