Reference: Mock Server
Intro
Develop web applications without heavy back-end services by running Express middleware or http server which can deliver mock responses.
Responses can be JSON or other formats to simulate REST services. Access-Control HTTP Headers are set by default to allow CORS requests. Mock services are configured in the routes.json file.
This server can return other file types besides XML or JSON (PDFs, images, etc). The appropriate response headers will be automatically set for different file types. For a complete list of file types supported view the mime types here.
Route Matching
availity-mock-server is designed to respond with the route configuration that matches the incoming request the closest by introspecting the request body, parameters and headers. availity-mock-server calculates which route scores the highest for each request and returns the appropriate mock response.
Configuration
Standalone Server
The default server configuration can be found in config.js. Pass a different configuration file to the availity-mock-server server to override the defaults.
const path = require('path');
const MockServer = require('@availity/mock-server');
const configPath = path.join(__dirname, 'path/to/config.js');
const server = new MockServer(configPath);
server.start();
Alternatively, pass options in the start method.
const = new MockServer();
.start({
data: path.join(__dirname, './data'),
routes: path.join(__dirname, './routes'),
plugins: ['@availity/mock-data']
}).then(function() {
// server started
});
Express Middleware
const express = require('express');
const app = express();
// This is the same as the stand-alone server use.
const MockServer = require('@availity/mock-server');
const server = new MockServer({/* options */});
app.use(server.middleware(/* options, same as `start` */);
app.listen(3001);
Options
- latency: Global delay for all reponses. The latency can be overridden per route configuration. Default is
250ms. - limit: Upload max size. Default is
50mb, - host: Server binds and listens for connections on the specified host. Default is
0.0.0.0. - port: Server binds and listens for connections on the specified port. Default is
9999. - data: Path to folder that contains the json mock responses.
- routes: Path(s) to configuration file that contains a mapping of the request/response routes. Multiple paths can be passed in with an array of strings.
- plugins: Array of NPM module names that enhance
@availity/mock-serverwith additional data and routes. @See @availity/mock-data - logProvider: Function that returns a logger that is used in place of the default logger. Inspired by the log provider in http-proxy-middleware
- pluginContext: A url context value which is used to rewrite every instance of
${context}variable in mock data responses. This can be useful for HATEOS links.
Simple
function logProvider(provider) {
return require('winston');
}
Advanced
function logProvider(provider) {
var logger = new (require('winston').Logger)();
var myCustomProvider = {
log: logger.log,
debug: logger.debug,
info: logger.info,
warn: logger.warn,
error: logger.error
};
return myCustomProvider;
}
Route Configuration Examples
The routes.json defines the mock responses for rest services. Below are some sample scenarios that should help you understand the configuration options.
The mock configuration supports deep nested introspection of JSON and multi-part form data when matching routes. See Example 6 below.
Simple
"v1/route1": {
"file": "example1.json" // response for GET|PUT|POST|DELETE
}
Status Code
"v1/route2": {
"latency": 250, // latency in (ms)
"file": "example2.json", // all GET|PUT|POST|DELETE requests
"status": 201 // return status code 201
}
POST with Default Response
"v1/route3": {
"file": "example3.json", // GET|PUT|DELETE requests
"post": "example1.json" // POST requests
}
CRUD
"v1/route4": {
"get": "example1.json", // all GET requests
"put": "example2.json", // all PUT requests
"post": "example3.json", // all POST requests
"delete": "example4.json" // all DELETE requests
}
CRUD using objects
"v1/route4": {
"get": {// all GET requests
"status": 204,
"responseHeader": {
"a": "1",
"b": "2"
}
},
"put": {// all PUT requests
"file": "example1.json",
},
"post": "example3.json", // all POST requests
"delete": "example4.json" // all DELETE requests
}
Query Params with Arrays and Regexes
"v1/route5": {
"file": "example1.json", // all POST|PUT|DELETE requests
"get": [
{
"file": "example2.json",
"status": 200, // default status code is 200
"params": { // GET /v1/router?a=1&b=2&c=3
"a": "1",
"b": "2",
"c": "3"
}
},
{
"file": "example3.json",
"params": { // GET /v1/router?a=1&a=2&a=3&a=4
"a": [1, 2, 3, 4]
}
},
{
"file": "example4.json",
"params": { // Regular expression configruation for matching params
"a": { // GET /v1/router?a=1 OR /v1/router?a=2 OR /v1/router?a=3
pattern: "1|2|3",
flags: "i" // Javascript regex flags to ignore case
}
}
},
]
}
POST Params
"v1/route6": {
"file": "example1.json", // all GET|PUT|DELETE requests
"post": [
{
"file": "example2.json",
"params": { // POST with JSON payload {"a": 1}
"a": 1
}
},
{
"file": "example3.json",
"params": { // POST with JSON payload {a: {b: {c: "1"} } }
"a.b.c": 1 // nested attributes supported
}
},
{
"file": "example4.json",
"params": { // POST with JSON payload {a : {b: [0,1,2] } }
"a.b[2]": 2 // nested array attributes supported
}
}
]
},
Multipart
<form action="/api/v1/users" method="post" enctype="multipart/form-data">
<p><input type="text" name="a" value="example" /></p>
<p>
<input type="file" name="b" />
<!--the name of the file is used below to match and score the proper response -->
</p>
<p><button type="submit">Submit</button></p>
</form>
"v1/route7": {
"file": "example1.json", // all GET|PUT|DELETE requests
"post": [
{
"file": "example2.json" // default response if none match below
},
{
"file": "example3.json",
"params": { // form submit where form fields a=1 and b="sample.pdf"
"a": 1,
"b": "sample.pdf"
}
},
{
"file": "example4.json",
"params": { // form submit where form fields a=2 and b="another.name.jpg"
"a": 2,
"b": "another.name.jpg"
}
}
]
}
Async Responses
"v1/route8": {
"file": "example1.json",
"get": [
{
"file": "example1.json",
"response": [
{
// first GET request to /v1/route8
"status": 202,
"file": "example1.json"
},
{
// second GET request to /v1/route8
"status": 201,
"file": "example2.json"
}
]
}
]
}
Async Responses with Repeat Option
"v1/route10": {
"get": [
{
"file": "example1.json",
"response": [
{
"status": 202,
"file": "example1.json",
"repeat": 3
},
{
"status": 202,
"file": "example2.json"
},
{
"status": 202,
"file": "example3.json",
"repeat": 4
},
{
"status": 201,
"file": "example4.json"
}
]
}
]
}
Match Headers
"v1/route11": {
"file": "example1.json",
"get": [
{
"file": "example2.json",
"headers": { // GET with header key-value pair b:2
"b": "2"
}
},
{
"file": "example3.json",
"headers": { // GET with header key-value pair b:3
"c": "3"
}
}
]
}
Url Redirect
"v1/route9": {
"url": "http://www.google.com"
}
If you omit the port, or set it to 0, @availity/mock-server will let the OS assign a random open port.
This allows you to run multiple servers without keeping track of all ports being used. (see Example 2)