ng-apimock core module is a Node.js plugin that provides the ability to use scenario based api mocking. You can use it for both:

• local development (see local development plugins)
• automated testing (see automated testing plugins)

npm install @ng-apimock/core --save-dev

Once the plugin has been installed, you can require it with this line of JavaScript:

const ngApimock = require('@ng-apimock/core');

ng-apimock consists of 2 parts.

1. processor - responsible for processing the available mocks and presets (see Processor)
2. middleware - responsible for handling api calls (see Middleware)

The processor is responsible for processing the available mocks and presets. In order to process the mocks and presets you need to call the processor like this:

ngApimock.processor.process({
    src: 'the/path/to/your/mocks',
    patterns: {
        mocks: '**/*.mock.json', // optional, defaults to **/*.mock.json,
        presets: '**/*.preset.json' // optional, defaults to **/*.preset.json
    },
    watch: true // optional, defaults to false
});

Every mock and preset will be processed that matches the pattern within the source directory. When duplicates (same name) mocks and preset are processed they will override the previously processed version (a message will be printed to the console).

The middleware function handles requests. The function is compatible with both Connect and Express

In order to use the middleware you can add the function to your serve configuration like this:

const connect = require('connect');
const app = connect();

app.use(ngApimock.middleware);

The default bodyParser library that is used has a body limit is 100kb. In order to increase the limit you can set the limit like this:

app.use(bodyParser.json({limit: '10mb'});

You can configure apimock with a configuration object.

apimock.configure({
    middleware:{
        useHeader: true, // optional indicator to use a header to get the identifier. (defaults to false)
        identifier: 'my-identifier' // optional name for the header or cookie to contain the identifier. (defaults to 'apimockid')
    }
});

Ng-apimock makes sure that parallel executed tests do not interfere with each other. Each session is fully isolated.

There are a couple of rules to follow.

1. For each api call create a separate file
2. Each file needs to follow the format below.

{
  "name": "some mock", // the name of the mock
  "isArray": true, // optional, indicator that indicates if the response data is an array or object (for json response)
  "request": {
    "url": "/items", // the regular express to match request urls
    "method": "GET", // the request method
    "body": {}, // optional, body object
    "headers": {} // optional, headers object
  },
  "responses": {
    "something": { // the name of the response
        "status": 200, // optional, http status code (defaults to 200)
        "data": {}, // optional, response data (either an object or array of objects)
        "file": "some/file.pdf", // optional, file location
        "headers": {}, // optional headers object  
        "statusText": "some message", // optional, status text
        "default": true, // optional, indicates if this response will be returned by default
        "delay": 1000 // optional, delay in milliseconds
    }
  }
}

Response data can contain time sensitive information. For those cases, static mock data is not flexible enough. Ng-apimock can interpolate those types of data for you. If you want to interpolate specific parts of your response data, you need to surround the part with %% like this:

{
    "responses" : {
        "some response": {
            "data": {
                "today": "%%today%%"
            }
        }
    }
}

These variables can be set using the available clients.

There are a couple of rules to follow.

1. For each preset create a separate file
2. Each file needs to follow the format below.

{
  "name": "some flow", // the name of the preset
  "mocks": {
    "some mock": { // the name of the mock
      "scenario": "success", // the name of the scenario
      "echo": true, // optional, indicates if this request will echoed to the console (defaults to false)
      "delay": 3000 // optional, delay in milliseconds (defaults to 0)
    }
  },
  "variables": {
    "some-variable": "some value"
  }
}

There are a couple of clients available to connect to @ng-apimock.

• @ng-apimock/protractor-plugin
• @ng-apimock/webdriver-plugin

• @ng-apimock/dev-interface

Ng-apimock provides the following options:

• Selecting a scenario

• Delaying a response

• Echoing a request

• Adding / updating a variable

• Deleting a variable

• Selecting a preset

• Recording request / responses

See the client documentation for each of these functions.