К основному содержанию
скилл CX Codex

api-testing · oakoss — скилл для Claude Code: тестирование API и установка

Скилл api-testing для Claude Code помогает писать интеграционные тесты REST API и проверять ответы эндпоинтов. Включается при настройке HTTP-моков или тестировании ошибок.

MIT 149 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill api-testing -a claude-code
Открыть на GitHub

Что делает api-testing

api-testing описывает тестирование HTTP-эндпоинтов с Supertest, MSW и Vitest. В нём есть приёмы для проверки статусов, заголовков и тела ответа, валидации схемы через Zod, организации тестов и обработки ошибок. MSW v2 перехватывает исходящие HTTP-запросы, а Supertest отправляет запросы к приложениям Express, Fastify и Hono без запуска отдельного сервера.

Для Fastify в Supertest передают fastify.server; у Fastify также есть собственный метод app.inject(). Скилл охватывает настройку обработчиков MSW и сброс их состояния между тестами. Для чистых функций он предлагает обычные проверки, а для браузерных E2E-тестов и нагрузочного тестирования называет другие инструменты: Playwright или Cypress, k6 или Artillery.

Какие задачи решает

  • проверить статусы и тело ответа REST-эндпоинта
  • смоделировать сбой внешнего HTTP-сервиса через MSW
  • проверить заголовки и схему ответа
  • организовать тесты для Express, Fastify или Hono

Примеры запросов агенту

  • Напиши интеграционные тесты для REST-эндпоинтов Express с проверкой статуса и тела ответа.
  • Замокай запрос к внешнему API через MSW и проверь сетевую ошибку.
  • Добавь проверку схемы ответа через Zod для эндпоинта Fastify.

Как установить api-testing

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill api-testing -a claude-code

2Вручную: положить файлы

~/.claude/skills/api-testing/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/api-testing/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об api-testing

Как установить api-testing в Claude Code?

Выполни npx skills add oakoss/agent-skills --skill api-testing -a claude-code. Файл скилла находится по пути ~/.claude/skills/api-testing/SKILL.md.

Что делает api-testing?

Помогает тестировать REST API: отправлять запросы, проверять ответы и перехватывать HTTP-запросы через MSW. Также описывает проверку схем и организацию тестов.

Чем тестирование Fastify отличается от Express в api-testing?

Для Fastify можно использовать app.inject() или передать Supertest объект fastify.server. Для Express Supertest работает с приложением напрямую.

Исходный текст

SKILL.md · MIT
---
name: api-testing
description: |
  API testing patterns with supertest, MSW, and Vitest. Covers integration testing for REST APIs, HTTP request mocking with Mock Service Worker v2, response assertions, schema validation, test organization, and framework-specific patterns for Express, Fastify, and Hono.

  Use when writing integration tests for REST APIs, mocking HTTP requests, or testing API endpoints. Use for api-test, supertest, msw, mock-service-worker, integration-test, http-mock, endpoint-test, request-test.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://mswjs.io/docs'
user-invocable: false
---

# API Testing

## Overview

API testing validates HTTP endpoints by sending requests and asserting responses, covering status codes, headers, body content, and error handling. Supertest provides a fluent chainable API for integration testing against Express, Fastify, and Hono apps without starting a real server. MSW (Mock Service Worker) v2 intercepts outgoing HTTP requests at the network level, enabling realistic mocking of external services in both Node.js tests and browser environments.

**When to use:** Integration tests for REST APIs, testing middleware pipelines, validating request/response contracts, mocking third-party APIs in tests, testing error handling and edge cases.

**When NOT to use:** Unit testing pure functions (use direct assertions), E2E browser testing (use Playwright/Cypress), load/performance testing (use k6/Artillery), testing static file serving.

## Quick Reference

| Pattern               | API                                        | Key Points                                  |
| --------------------- | ------------------------------------------ | ------------------------------------------- |
| GET request           | `request(app).get('/path')`                | Returns supertest `Test` object             |
| POST with body        | `request(app).post('/path').send(body)`    | Automatically sets Content-Type             |
| Auth header           | `.set('Authorization', 'Bearer token')`    | Chain before `.expect()`                    |
| Status assertion      | `.expect(200)`                             | Chainable with body assertions              |
| Body assertion        | `.expect({ key: 'value' })`                | Deep equality check                         |
| Header assertion      | `.expect('Content-Type', /json/)`          | Accepts string or regex                     |
| MSW HTTP handler      | `http.get('/api/users', resolver)`         | Intercepts matching requests                |
| MSW GraphQL handler   | `graphql.query('GetUser', resolver)`       | Intercepts by operation name                |
| MSW response          | `HttpResponse.json(data, { status })`      | v2 response format                          |
| MSW error simulation  | `HttpResponse.error()`                     | Simulates network failure                   |
| MSW one-time handler  | `http.get(path, resolver, { once: true })` | Auto-removed after first match              |
| MSW per-test override | `server.use(handler)`                      | Override default handlers in specific tests |
| Schema validation     | `schema.parse(response.body)`              | Validates response structure with Zod       |
| Cookie persistence    | `const agent = request.agent(app)`         | Maintains cookies across requests           |
| Fastify inject        | `app.inject({ method, url })`              | Built-in testing without supertest          |
| Hono test client      | `testClient(app)`                          | Type-safe request builder                   |

## Common Mistakes

| Mistake                                    | Correct Pattern                                             |
| ------------------------------------------ | ----------------------------------------------------------- |
| Not awaiting supertest requests            | Always `await request(app).get('/path')`                    |
| Sharing server state between tests         | Reset handlers with `server.resetHandlers()` in `afterEach` |
| Mocking fetch/axios directly               | Use MSW to intercept at the network level                   |
| Forgetting `server.listen()` in setup      | Call in `beforeAll`, `resetHandlers` in `afterEach`         |
| Passing Fastify instance to supertest      | Use `fastify.server` (the underlying Node server)           |
| Asserting before response completes        | Use `await` or return the supertest chain                   |
| Hardcoding test data across many tests     | Use factories or fixtures for test data                     |
| Not testing error responses                | Test 4xx and 5xx paths alongside happy paths                |
| Using `server.close()` in `afterEach`      | Use `afterAll` for close, `afterEach` for reset only        |
| Ignoring response headers in assertions    | Validate Content-Type, Cache-Control, CORS headers          |
| Not using `onUnhandledRequest: 'error'`    | Catch unhandled requests to prevent silent test gaps        |
| Testing implementation instead of behavior | Assert on response shape, not internal function calls       |

## Delegation

- **Test structure review**: Use `Task` agent
- **Code review**: Delegate to `code-reviewer` agent
- **Pattern discovery**: Use `Explore` agent

> If the `vitest-testing` skill is available, delegate general Vitest configuration and patterns to it.
> Otherwise, recommend: `npx skills add oakoss/agent-skills --skill vitest-testing`

## References

- [Supertest integration testing patterns for Express, Fastify, and Hono](references/supertest-patterns.md)
- [MSW request handlers, response resolvers, and server setup](references/msw-handlers.md)
- [Test organization, fixtures, factories, and setup/teardown](references/test-organization.md)
- [Response assertions, status codes, headers, and schema validation](references/assertion-patterns.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Тесты и QA» →

Сначала — api-testing от других авторов.

api-testing kindlmann Скилл api-testing для Claude Code помогает писать тесты REST- и GraphQL API. Включается при проверке схемы ответа, авторизации, ошибок и пагинации. CX Codex +1 1 800установок api-testing secondsky Скилл api-testing для Claude Code учит агента писать тесты HTTP API на Supertest (TypeScript) и httpx (Python). Покрывает REST, GraphQL, проверку ошибок и авторизацию. CX Codex +1 921установок api-testing fugazi Скилл api-testing помогает проверять контракты REST- и GraphQL-эндпоинтов. Он пригодится для тестов схем, авторизации, ошибок и граничных случаев без управления браузером. CX Codex +1 112установок api-testing laurigates Скилл api-testing для написания тестов REST и GraphQL API через Supertest (TypeScript) и httpx/pytest (Python). Проверяет статусы, схемы ответов, аутентификацию и обработку ошибок. CX Codex +1 106установок playwright-api-testing-cursorrules-prompt-file PatrickJS Правило playwright-api-testing-cursorrules-prompt-file настраивает Cursor для генерации API-тестов на Playwright с плагином pw-api-plugin. Помогает проверять статус-коды и валидировать схемы данных с Zod. CX Codex +1 ★ 41 178звёзд репо integration-testing aj-geddes Скилл integration-testing помогает проектировать и писать интеграционные тесты для API, баз данных, очередей сообщений и внешних сервисов. Пригодится при сквозной проверке компонентов системы. CX Codex +1 564установок jest-testing pluginagentmarketplace Скилл jest-testing для Claude Code помогает проектировать тесты Node.js-приложений на Jest — от отдельных функций до API с Supertest. Помогает настраивать моки и собирать отчёт о покрытии. CX Codex +1 121установок sveltekit-restful-api-tailwind-css-cursorrules-pro PatrickJS Правило sveltekit-restful-api-tailwind-css-cursorrules-pro для Cursor задаёт рекомендации разработки на SvelteKit: REST API, Tailwind CSS, тесты, документация и Windows-команды. Закрепляет требования стека в проекте. CX Codex +1 ★ 41 178звёзд репо api-test-suite-builder Alireza Rezvani Скилл api-test-suite-builder для Claude Code находит API-маршруты и генерирует тесты для них. Запускается по запросу создать проверки REST-точек, интеграционный набор или контрактные тесты. CX Codex +1 660установок api-test-suite-generator patricio0312rev Скилл api-test-suite-generator для Claude Code сканирует определения маршрутов и генерирует тесты API на Jest, Vitest или Supertest. Закрывает покрытие эндпоинтов, у которых тестов ещё нет. CX Codex +1 319установок

Из того же набора106

Весь набор →
changesets Скилл changesets помогает вести версии и changelog пакетов в монорепозитории. Он пригодится для согласованных релизов и публикации пакетов в npm. CX Codex +1 154установок opentofu Помогает писать и проверять конфигурации OpenTofu и Pulumi. Помогает управлять инфраструктурой, состоянием и окружениями из кода. CX Codex +1 153установок arktype-validation Скилл arktype-validation для Claude Code описывает схемы ArkType строками в синтаксисе TypeScript, включая морфы и рантайм-валидацию данных и переменных окружения через ArkEnv. CX Codex +1 153установок tanstack-router Скилл tanstack-router настраивает типобезопасную файловую маршрутизацию в React через @tanstack/react-router. Помогает с лоадерами данных, валидацией параметров поиска и разделением кода. CX Codex +1 150установок github-actions Помогает создавать и настраивать GitHub Actions workflows: от триггеров и матриц сборки до кеширования и аутентификации. Автоматизирует тесты, релизы и развёртывание. CX Codex +1 149установок git-workflow Скилл git-workflow помогает агенту выстраивать trunk-based разработку, оформлять conventional commits, настраивать пайплайны GitHub Actions и чистить историю Git. CX Codex +1 149установок ux-designer Скилл ux-designer для ИИ-агентов: проводит проект от информационной архитектуры до передачи в разработку, с проверкой доступности и юзабилити. CX Codex +1 148установок responsive-images Скилл responsive-images внедряет адаптивные изображения с srcset, современными форматами AVIF и WebP, защищая от сдвигов верстки CLS и ускоряя LCP. CX Codex +1 148установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой