https://github.com/jaredwray/mockhttp

Mock Http Server (httpbin replacement)
https://github.com/jaredwray/mockhttp

fastify http httpbin https mock mock-server nodejs

Last synced: 3 days ago
JSON representation

Mock Http Server (httpbin replacement)

• Host: GitHub
• URL: https://github.com/jaredwray/mockhttp
• Owner: jaredwray
• License: mit
• Created: 2024-11-05T20:42:08.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2024-12-31T20:56:05.000Z (7 days ago)
• Last Synced: 2024-12-31T20:57:22.544Z (7 days ago)
• Topics: fastify, http, httpbin, https, mock, mock-server, nodejs
• Language: TypeScript
• Homepage: https://mockhttp.org
• Size: 196 KB
• Stars: 4
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![public/logo.svg](public/logo.svg)](https://mockhttp.org)

[![tests](https://github.com/jaredwray/mockhttp/actions/workflows/tests.yaml/badge.svg)](https://github.com/jaredwray/mockhttp/actions/workflows/tests.yaml)

[![GitHub license](https://img.shields.io/github/license/jaredwray/mockhttp)](https://github.com/jaredwray/mockhttp/blob/master/LICENSE)

[![codecov](https://codecov.io/gh/jaredwray/mockhttp/graph/badge.svg?token=eqtqoA3olU)](https://codecov.io/gh/jaredwray/mockhttp)

[![npm](https://img.shields.io/npm/dm/@jaredwray/mockhttp)](https://npmjs.com/package/@jaredwray/mockhttp)

[![npm](https://img.shields.io/npm/v/@jaredwray/mockhttp)](https://npmjs.com/package/@jaredwray/mockhttp)

[![Docker Pulls](https://img.shields.io/docker/pulls/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`.

# Deploy via Docker

```bash

docker run -d -p 3000:3000 jaredwray/mockhttp

```

# Deploy via NodeJS

```bash

npm install @jaredwray/mockhttp --save

```

then run `mockhttp` in your code.

```javascript

import { mockhttp } from '@jaredwray/mockhttp';

mockhttp.start(); // start the server

const response = await fetch('http://localhost:8080/ip');

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 but many people will not see it. It is ran via [Cloudflare](https://cloudflare.com) and [Google Cloud Run](https://cloud.google.com/run/) across 7 regions globally.

# 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)