Синтетические loopback-серверы для Computer QA пространства HTTP. Не используют vault, внешние сервисы, рабочие данные, TLS или HTTP/2. Задержки и интервалы сервера управляют тестовым сценарием — это не измерения производительности приложения. Для оценки производительности используйте изолированный benchmark vault. Профили собирайте отдельными запусками, чтобы профилирование не влияло на замеры времени.

pnpm http:server
pnpm http:server --help
pnpm http:server -- --transport-port 0 --cross-origin-port 0

Все сервисы слушают 127.0.0.1. Флаги принимают целое число от 0 до 65535; 0 выбирает свободный порт автоматически. После готовности всех слушателей stdout выводит одну JSON-строку:

{ "event": "ready", "addresses": { "websocket": "ws://127.0.0.1:5188", "scripts": "http://127.0.0.1:5189", "showcase": "http://127.0.0.1:5190", "graphql": "http://127.0.0.1:4399", "transport": "http://127.0.0.1:5191", "crossOrigin": "http://127.0.0.1:5192" } }

Адреса содержат реальные порты, включая автоматически выбранные. При ошибке запуска сервер закрывает уже открытые слушатели и завершается с ненулевым кодом. SIGINT / SIGTERM закрывают HTTP-соединения, активные WebSocket и таймеры; текущие запросы могут быть прерваны. Ошибки конфигурации выводятся в stderr. Импорт модулей не запускает слушатели: в тестах можно вызвать startServers(ports) и затем дождаться close().

Токены — публичные тестовые значения. Все сервисы запускаются одной командой pnpm http:server на указанных выше портах.

• Scripts: /health возвращает {"demo":"masscode-http-scripts"}. Остальные запросы возвращают {"token":"demo-token","received":"<исходное тело>"}. Тело длиннее 65 536 JavaScript-символов получает 413.
• WebSocket: / повторяет текстовые и бинарные сообщения. /protected сначала отправляет {type:"connected", authenticated:true, channel, clientId}, затем повторяет сообщения. Неверный bearer-токен получает 401; отсутствие channel или client ID — 400; неизвестный путь — 404. Обычный HTTP получает 426. Максимальное сообщение: 1 MiB.
• GraphQL: POST /graphql с JSON {query, variables?, operationName?}. Поля Query: hello (Hello GraphQL), token (graphql-demo), user(id: ID!) (имя по умолчанию Ada), broken (ошибка поля с кодом DEMO_ERROR). Мутация rename(id: ID!, name: String!) сохраняет имя в текущем экземпляре. Неверная авторизация получает 401, неправильные метод/путь — 404, некорректный JSON или тело длиннее 1 000 000 JavaScript-символов — 400. Ошибки исполнения GraphQL остаются ответами GraphQL со статусом 200.
• Showcase: необязательный префикс /v1. Публичные маршруты: /health, /metrics, /status/maintenance (503), POST /auth/token. Защищённые: /products (фильтр category), /products/:id, /customers, /customers/:id, /orders, /orders/:id. POST /orders принимает {customerId, items:[{productId, quantity}]} и использует первый товар; некорректные данные получают 422. POST /orders/:id/fulfillment переводит заказ в статус shipped. Исходный заказ — ord_1042, первый новый — ord_1043. Товары: prd_weekender, prd_bottle, prd_tote; покупатели: cus_2048, cus_2049. Ограничение JSON-тела: 65 536 JavaScript-символов (413). Некорректный JSON получает 400. Сохранены исходные данные, фиксированные заголовки request ID, rate limit и no-store.

Основной и второй слушатели предоставляют одинаковые маршруты. /cross-origin указывает на реальный /echo соседнего слушателя. Произвольного адреса перенаправления нет. Разные порты позволяют проверить смену HTTP origin; cookies привязаны к хосту и не изолируются портом. Политика браузерного CORS не добавляется.

Числовые параметры содержат только десятичные цифры. Отсутствующие, отрицательные, дробные, нечисловые и выходящие за границы значения получают 400 с JSON {error}. Неподдерживаемые методы получают 405, неизвестные GET-маршруты — 404. Echo и редиректы принимают обычные HTTP-методы GET, HEAD, POST, PUT, PATCH, DELETE и OPTIONS. Заголовки запроса вроде host и connection закономерно зависят от клиента.

Вызывайте /reset, когда запросы завершены. Сброс не отменяет текущие запросы: параллельная мутация может исполниться после сброса и снова изменить состояние. Разные вызовы startServers() полностью разделяют изменяемое состояние.

На Transport доступен изолированный журнал по ID прогона ([A-Za-z0-9_-], 1–64 символа):

• GET /qa/<runId>/state возвращает {runId, requests}. Чтение не увеличивает счётчик; неизвестный ID возвращает пустой журнал.
• POST /qa/<runId>/reset очищает только этот журнал; новые запросы получают sequence с 1.
• /qa/<runId>/echo?delay=0 принимает HTTP-запрос, записывает sequence, method, path, body и state; отвечает JSON со статусом 200. delay — 0–10 000 мс. Запись появляется до задержки ответа, поэтому потерянный ответ не означает отсутствие dispatch.

Журнал содержит максимум 100 запросов на ID и 20 ID на слушатель (дальше 429). Тело ограничено 16 KiB (413 с записью rejected); не используйте реальные данные или секреты. Заголовки не сохраняются. Состояния receiving, received, rejected, aborted отражают приём запроса, а не доставку ответа клиенту. После reset старый отложенный ответ не восстанавливает журнал. Разные слушатели имеют разные журналы; глобальный /reset не заменяет reset конкретного QA ID.

Перед проверкой подтверждения сбросьте журнал, после подготовки preview проверьте ноль записей, после принятия — одну запись с ожидаемыми методом/телом. Повтор клика/IPC не должен добавлять вторую. Этот fixture доказывает dispatch; число выполнений пользовательского скрипта проверяется отдельно по runtime-результату/инструментированному тесту, а не по демонстрационному /metrics.

pnpm test scripts/http-dev-server
pnpm exec eslint scripts/http-dev-server scripts/http-graphql-fixtures.mjs