forwardemail/supertest
Supertest
🕷 Super-agent driven library for testing node.js HTTP servers using a fluent API. Maintained for @forwardemail, @ladjs, @spamscanner, @breejs, @cabinjs, and @lassjs.
Features
- Fluent Endpoint Testers - Core purpose: testing Node.js HTTP servers with a fluent API for requests and assertions.
- HTTP Client Libraries - Wraps the SuperAgent HTTP library to provide a unified interface for requests and responses.
- Test Clients - Core identity: a tool for sending requests to HTTP servers and verifying responses.
- Integration Test Libraries - Core identity: an assertion library for testing Node.js HTTP servers with fluent expectations.
- API Endpoint Testing - Core purpose: testing HTTP endpoints with a fluent chain of assertions on status, headers, body, and cookies.
- Fluent Assertion Chaining - Implements fluent assertion chaining by returning the request object for sequential configuration.
- HTTP Response Assertions - Ships built-in matchers for verifying HTTP response status, headers, body, and cookies.
- Fluent Assertions - Chains request setup, response assertions, and transformations in a single readable expression.
- Basic Authentication - Attaches HTTP Basic credentials to requests using the same interface as the underlying HTTP client.
- Cookie State Verification - Provides cookie state verification assertions for integration tests.
- Ordered Expectation Chains - Enables sequential assertion chains with response transformations between checks.
- Assertion Utilities - Provides utilities for verifying cookie presence, absence, and options in HTTP responses.
- Request Lifecycle Hooks - Intercepts request preparation and response parsing to inject authentication and transformation logic.
