https://github.com/jaredwray/mockhttp
A simple HTTP server that can be used to mock HTTP responses for testing purposes. Inspired by httpbin and built using nodejs and fastify with the idea of running it via https://mockhttp.org, via docker jaredwray/mockhttp, or nodejs npm install jaredwray/mockhttp.
https://github.com/jaredwray/mockhttp
fastify http httpbin https mock mock-server nodejs
Last synced: about 1 month ago
JSON representation
A simple HTTP server that can be used to mock HTTP responses for testing purposes. Inspired by httpbin and built using nodejs and fastify with the idea of running it via https://mockhttp.org, via docker jaredwray/mockhttp, or nodejs npm install jaredwray/mockhttp.
- Host: GitHub
- URL: https://github.com/jaredwray/mockhttp
- Owner: jaredwray
- License: mit
- Created: 2024-11-05T20:42:08.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-05T18:04:43.000Z (about 1 month ago)
- Last Synced: 2025-04-10T08:01:19.362Z (about 1 month ago)
- Topics: fastify, http, httpbin, https, mock, mock-server, nodejs
- Language: TypeScript
- Homepage: https://mockhttp.org
- Size: 250 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://mockhttp.org)
[](https://github.com/jaredwray/mockhttp/actions/workflows/tests.yaml)
[](https://github.com/jaredwray/mockhttp/blob/master/LICENSE)
[](https://codecov.io/gh/jaredwray/mockhttp)
[](https://npmjs.com/package/@jaredwray/mockhttp)
[](https://npmjs.com/package/@jaredwray/mockhttp)
[](https://hub.docker.com/r/jaredwray/mockhttp)
A simple HTTP server that can be used to mock HTTP responses for testing purposes. Inspired by [httpbin](https://httpbin.org/) and built using `nodejs` and `fastify` with the idea of running it via https://mockhttp.org, via docker `jaredwray/mockhttp`, or nodejs `npm install jaredwray/mockhttp`.
# Features
* All the features of [httpbin](https://httpbin.org/)
* `@fastify/helmet` built in by default
* Built with `nodejs`, `typescript`, and `fastify`
* Deploy via `docker` or `nodejs`
* Global deployment via [mockhttp.org](https://mockhttp.org) (free service)
* Better API documentation and examples
* Auto detect the port that is not in use
* Maintained and updated regularly!
# Deploy via Docker
```bash
docker run -d -p 3000:3000 jaredwray/mockhttp
```
# Deploy via Docker Compose
```yaml
services:
mockhttp:
image: jaredwray/mockhttp:latest
ports:
- "3000:3000"
```
If you want to run it on a different port, just change the `3000` to whatever port you want and add in the environment variable `PORT` to the environment.
```yaml
services:
mockhttp:
image: jaredwray/mockhttp:latest
ports:
- "3001:3001"
environment:
- PORT=3001
```
You can see an example of this in the [docker-compose.yaml](docker-compose.yaml) file.
# Deploy via NodeJS
```bash
npm install @jaredwray/mockhttp --save
```
then run `mockhttp` in your code.
```javascript
import { mockhttp } from '@jaredwray/mockhttp';
await mockhttp.start(); // start the server
const response = await fetch('http://localhost:3000/get');
console.log(reaponse);
await mockhttp.stop(); // stop the server
```
# About mockhttp.org
[mockhttp.org](https://mockhttp.org) is a free service that runs this codebase and allows you to use it for testing purposes. It is a simple way to mock HTTP responses for testing purposes. It is globally available has some limitations on it to prevent abuse such as requests per second. It is ran via [Cloudflare](https://cloudflare.com) and [Google Cloud Run](https://cloud.google.com/run/) across 7 regions globally and can do millions of requests per second.
# Contributing
Please read our [CODE OF CONDUCT](CODE_OF_CONDUCT.md) and [CONTRIBUTING](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
# License
[MIT License & © Jared Wray](LICENSE)