SuperTest

Spec sheet

Purpose

SuperTest is a library for testing Node.js HTTP servers with a fluent API.Read 11 Oct 2026 · github.com

License

The repository identifies the project as MIT licensed; the license grants permission to use, copy, modify, publish, distribute, sublicense, and sell copies subject to its conditions.Read 11 Oct 2026 · github.com

Assertions

The API supports assertions on response status, body, headers, and custom assertion functions.Read 11 Oct 2026 · github.com

Async styles

Examples show callback, promise, and async/await usage.Read 11 Oct 2026 · github.com

Async usage

The examples show callback, promise, and async/await styles for making requests and checking responses.Read 5 Oct 2026 · github.com

HTTP assertions

It provides a high-level abstraction for HTTP testing while allowing use of SuperAgent’s lower-level API.Read 11 Oct 2026 · github.com

Install

The README instructs users to install SuperTest from npm with npm install supertest --save-dev.Read 11 Oct 2026 · github.com

Installation

The README says to install it as an npm development dependency with `npm install supertest --save-dev`.Read 5 Oct 2026 · github.com

Maintainer

The repository says SuperTest is maintained for Forward Email and several other projects, including Lad, Spam Scanner, Bree, Cabin, and Lass.Read 5 Oct 2026 · github.com

Maintainers

The repository says SuperTest is maintained for Forward Email, Lad, Spam Scanner, Bree, Cabin, and Lass.Read 11 Oct 2026 · github.com

Noted limitation

When using .end(), failed .expect() assertions are delivered as an error to the callback and must be rethrown or passed to the test’s done() callback to fail the test.Read 11 Oct 2026 · github.com

Persistent cookies

request.agent() can persist cookies between requests, and the README documents cookie assertions.Read 11 Oct 2026 · github.com

Protocol

The README shows enabling HTTP/2 by passing {"http2":true} to request() or request.agent().Read 11 Oct 2026 · github.com

Security reporting

The security policy asks reporters to email [email protected] and says a bug bounty may be awarded at the maintainers’ discretion depending on severity.Read 11 Oct 2026 · github.com

Server setup

You can pass an HTTP server or a function to request(), and SuperTest binds a server that is not already listening to an ephemeral port.Read 11 Oct 2026 · github.com

SuperAgent features

The README says SuperAgent methods such as write() and pipe() are available, including multipart file uploads.Read 11 Oct 2026 · github.com

Target use

The project describes itself as a library for testing Node.js HTTP servers with a fluent API.Read 5 Oct 2026 · github.com

Test frameworks

The README says SuperTest works with any test framework and demonstrates Mocha usage.Read 11 Oct 2026 · github.com

Plans and prices

Every SuperTest plan and price →

Where Specifiction places it

• API Testing Tools#31 of 347.3