#fake-server
** Please Note: ** This repo is no longer maintained and has known security vulnerabilities. Use at your own risk!
Fake-server is a generic and non-intrusive tool used to mock any server response. It has been designed to address issues when running tests against unstable or slow external servers.
===========
The idea is to create a webserver listening in a different port and make your tests bring it up and configure how it should behave against each different request. "Configuration" can be done by posting the parameters and desired response to the server, or through configuration files inside ./default_routes/.
For every request, fake-server will try to match against the configured URIs and return the expected response.
- No need to instrument your code (as long as the external server endpoint is configurable :P)
- Generic enough to work with blackbox or whitebox tests.
- No database required
Clone this repository (npm package coming soon)
git clone [email protected]:yahoo/fake-server.git
Start (it will start a server on port 3012)
node server.js
Let's say you want "/test" to always return "hello" and "/foo" to return a 404.
All you have to do is POST to http://localhost:3012/add/ the following data:
Configure /test by posting:
{ route: '/test',
responseCode: 200,
responseBody: "hello" }
one of the many ways to do this is using cURL:
curl http://localhost:3012/add -X POST -H "Content-Type:application/json" -H "Accept:application/json" \
-d '{"route":"/test","responseCode":200,"responseBody":"hello"}'
now let's configure our 404 example by sending this to the server:
{ route: '/foo',
responseCode: 404,
responseBody: "Not found" }
using cURL:
curl http://localhost:3012/add -X POST -H "Content-Type:application/json" -H "Accept:application/json" \
-d '{"route":"/foo","responseCode":404,"responseBody":"Not found"}'
now, in your browser you can see the results:
http://localhost:3012/foo
http://localhost:3012/test
Configuration is done by sending a POST request to /add or by placing a json file containing configurations inside a "routes" object (see default_routes/sample.json for reference). Here are the supported features for this version:
This will match http://localhost:3012/news/007 as well as http://localhost:3012/news/1231293871293827:
{ route: '/news/[0-9]'
responseCode: 200,
responseBody: 'whatever you want' }
Fake-server supports "POST" calls and uses payload for matching. Regexs are supported for payload matching, and paths can be used to specify inner properties of JSON payloads:
{ route: '/news'
payload: {
id: [\d+], requests[1].user.login: 'jdoe', month: "february" },
responseCode: 200,
responseBody: 'yay! it matches'
}
{ route: '/news', queryParams: { id: "[\d+]", location: "Hawaii" }
responseCode: 200,
responseBody: 'Regex matching rocks'
}
... can also use the request Headers. So you can check if specific cookies are present, for instance
{ route: '/secure',
requiredHeaders: {
X-Auth: "secret",
},
responseCode: 200,
responseBody: 'header is there'
}
The following configuration example will return the output of ./mock_data/sample.json (notice the parameter is called responseData instead of responseBody)
{ route: '/',
responseCode: 200,
responseData: './mock_data/sample.json' }
This will return '200' in the first two requests to '/' and 403 on the third request
{ route: '/',
responseCode: 200,
responseBody: 'ok' }
note that I will be adding an 'at' parameter to configure the special behavior to the third request:
{ route: '/',
responseCode: 403,
responseBody: 'Thou shall not pass!',
at: 3 }
The following will delay server response in one second:
{ route: '/slow/.*',
responseCode: 200,
responseBody: 'OK',
delay: 1000 }
To avoid the need to restart fake-server in order to clear the configuration, we've implemented a special endpoint called /flush. By sending a DELETE request to http://localhost:3012/flush, you will erase all previously configured responses.
- There are two reserved endpoints: POST '/add' and
DELETE'/flush'. These cannot be used by your application.