# SuperTest

Node.js library that tests HTTP servers with a fluent API of request and response assertions.


Source: https://findsoftware.frbit.cloud/supertest/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- repository: https://github.com/forwardemail/supertest
- docs: https://github.com/forwardemail/supertest/blob/master/README.md

### Identity

- status: active
- maintainer: TJ Holowaychuk
- maintainerType: individual
- parent: unknown
- firstRelease: 2012
- hqCountry: unknown

### Kind

- category: testing
- hosting: not applicable
- language: javascript
- runtime: node
- runtimeMin: node 14
- basedOn: superagent

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: unknown
- renderingModes: not applicable
- installMethod: npm

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 7
- latestReleaseDate: 2026-11-07

### Adoption

- githubStargazers: 14412
- packagistDownloads: not applicable
- npmWeeklyDownloads: 25263492
- contributors: 92
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 416427
- dependentPackages: 19319

### Sources

- urls: https://api.github.com/repos/forwardemail/supertest (read 2026-11-16)
- urls: https://raw.githubusercontent.com/forwardemail/supertest/master/README.md (read 2026-11-16)
- maintainer: https://raw.githubusercontent.com/forwardemail/supertest/master/LICENSE (read 2026-11-16)
- maintainerType: https://raw.githubusercontent.com/forwardemail/supertest/master/LICENSE (read 2026-11-16)
- language: https://api.github.com/repos/forwardemail/supertest (read 2026-11-16)
- category: https://raw.githubusercontent.com/forwardemail/supertest/master/README.md (read 2026-11-16)
- basedOn: https://raw.githubusercontent.com/forwardemail/supertest/master/README.md (read 2026-11-16)
- runtime: https://api.github.com/repos/forwardemail/supertest (read 2026-11-16)
- runtimeMin: https://raw.githubusercontent.com/forwardemail/supertest/v7.3.2/package.json (read 2026-11-16)
- installMethod: https://raw.githubusercontent.com/forwardemail/supertest/master/README.md (read 2026-11-16)
- license: https://api.github.com/repos/forwardemail/supertest (read 2026-11-16)
- currentMajor: https://api.github.com/repos/forwardemail/supertest/releases (read 2026-11-16)
- latestReleaseDate: https://api.github.com/repos/forwardemail/supertest/releases (read 2026-11-16)
- firstRelease: https://registry.npmjs.org/supertest (read 2026-11-16)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/supertest (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/supertest (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/supertest (read 2026-11-16)
- githubStargazers: https://api.github.com/repos/forwardemail/supertest (read 2026-11-16)
- contributors: https://api.github.com/repos/forwardemail/supertest/contributors?per_page=1 (read 2026-11-16)

## Notes

SuperTest tests Node.js HTTP servers by sending them requests and asserting on the responses, through a fluent API of request and response assertions. It is built on superagent, which the README names as the library it is driven by.

It is installed as a development dependency from npm. The README says it works with any test framework and shows examples with mocha.

## Worth knowing

An expect() failure inside an end() callback does not throw. The README says the test has to rethrow the error or pass it to done to fail.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
