SuperTest

What it does

Assertions

The API supports assertions on response status, body, headers, and custom assertion functions.checked 11 Oct 2026

Async styles

Examples show callback, promise, and async/await usage.checked 11 Oct 2026

Async usage

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

HTTP assertions

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

Install

The README instructs users to install SuperTest from npm with npm install supertest --save-dev.checked 11 Oct 2026

Installation

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

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.checked 11 Oct 2026

Maintainer

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

Maintainers

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

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.checked 11 Oct 2026

Persistent cookies

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

Protocol

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

Purpose

SuperTest is a library for testing Node.js HTTP servers with a fluent API.checked 11 Oct 2026

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.checked 11 Oct 2026

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.checked 11 Oct 2026

SuperAgent features

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

Target use

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

Test frameworks

The README says SuperTest works with any test framework and demonstrates Mocha usage.checked 11 Oct 2026