HttpResponseSimulator Generate responses with a specific behaviour

What is this?

I you have a better name than HttpResponseSimulator just hit me up. It's just a tool that will allow you to define the behaviour you want a response to have. I built it over an afternoon so that I could write a test for an http client wrapper, to ensure timeouts would be handled properly since there was no way to reach the wrapped client directly. The first version came to life after an hour once I familiarized myself again with Node.js.

Eventually I added a few more advances over the past few days in order to make it a better tool. Now it serves a few more purposes than waiting a few seconds before responding. Then came the quality I needed to set before making it open-source and hopefully have people using it and helping it grow. And now it feels ready.

If you want to contribute you can send your ideas here or open pull requests there.

Supported inputs

The API is predictibly available at /api, don't blame my lack of creativity that started as an afternoon project. Below you can see the supported verbs and formats.

URL parameters Form JSON
GET YES NO NO
POST NO YES YES
PUT NO YES YES

Supported parameters

Key Type Action
wait Integer If positive, the response will be sent after waiting the specified value in milliseconds. (i.e. if the value is 200, the app will wait 200ms before responding)
pastebinId String If valid, the response will be the data matching that pastebin id.
echo String If set, the response will be the value passed.
responseUrl String If it is a valid and freely accessible url from a GET request, the data returned in the response will match the data you would get from that uri.
statusCode Integer If valid, will set the response status code.
accept String If valid, will set the response content type.

Examples

Get response from a pastebin id after 300 milliseconds

For the parameters request: wait=300&pastebinId=h5R3XNAj You will get the following response after waiting 300 milliseconds: I guess you know how to use the HttpResponseSimulator now.

Get a 500 error code with the default response handler response after 1 second.

For the parameters request: wait=1000&statusCode=500 You will get the following response after waiting 1 second: Waited 1000ms to respond. However if you trigger the same request through Postman, you can see the status code set to 500. 500 captured