mockserver-client
    TypeScript icon, indicating that this package has built-in type declarations

    5.11.2 • Public • Published

    mockserver-client-node

    Communicate with a MockServer from any node or grunt build

    Build status Dependency Status devDependency Status

    NPM

    Community

    • Backlog:                     Trello Backlog
    • Freature Requests:  Github Issues
    • Issues / Bugs:           Github Issues
    • Chat:                           Join Slack

    Getting Started

    MockServer allows you to mock any system you integrate with via HTTP or HTTPS (i.e. (REST) services, web sites, etc). Please note that it is a third party project that needs java.

    This npm module allows any grunt or node project to easily communicate with a running MockServer instance.

    As an addition to this module for communicating with a running MockServer there is a second project that can be used to start and stop a MockServer called mockserver-node.

    The MockServer client can be created as follows:

    var mockServer = require('mockserver-client'),
        mockServerClient = mockServer.mockServerClient // MockServer and proxy client

    Note: this assumes you have an instance of MockServer running on port 1080. For more information on how to do so check mockserver-node.

    Setup Expectation

    A simple expectation can be set up as follows:

    mockServerClient("localhost", 1080)
        .mockSimpleResponse('/somePath', { name: 'value' }, 203)
        .then(
            function(result) {
                // do something next
            }, 
            function(error) {
                // handle error
            }
        );

    A more complex expectation can be set up like this:

    mockServerClient("localhost", 1080)
        .mockAnyResponse(
            {
                'httpRequest': {
                    'method': 'POST',
                    'path': '/somePath',
                    'queryStringParameters': [
                        {
                            'name': 'test',
                            'values': [ 'true' ]
                        }
                    ],
                    'body': {
                        'type': "STRING",
                        'value': 'someBody'
                    }
                },
                'httpResponse': {
                    'statusCode': 200,
                    'body': JSON.stringify({ name: 'value' }),
                    'delay': {
                        'timeUnit': 'MILLISECONDS',
                        'value': 250
                    }
                },
                'times': {
                    'remainingTimes': 1,
                    'unlimited': false
                }
            }
        )
        .then(
            function(result) {
                // do something next
            }, 
            function(error) {
                // handle error
            }
        );

    For the full documentation see MockServer - Creating Expectations.

    Verify Requests

    It is also possible to verify that request were made:

    mockServerClient("localhost", 1080)
        .verify(
            {
                'method': 'POST',
                'path': '/somePath',
                'body': 'someBody'
            }, 
            1, true
        )
        .then(
            function() {
                // do something next
            }, 
            function(failure) {
                // handle verification failure
            }
        );

    It is furthermore possible to verify that sequences of requests were made in a specific order:

    mockServerClient("localhost", 1080)
        .verifySequence(
            {
                'method': 'POST',
                'path': '/somePathOne',
                'body': 'someBody'
            },
            {
                'method': 'GET',
                'path': '/somePathTwo'
            },
            {
                'method': 'GET',
                'path': '/somePathThree'
            }
        )
        .then(
            function() {
                // do something next
            }, 
            function(failure) {
                // handle verification failure
            }
        );

    For the full documentation see MockServer - Verifying Requests.

    Contributing

    In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

    Changelog

    All notable and significant changes are detailed in the MockServer changelog


    Task submitted by James D Bloom

    Analytics

    Install

    npm i mockserver-client

    DownloadsWeekly Downloads

    24,230

    Version

    5.11.2

    License

    Apache-2.0

    Unpacked Size

    74.8 kB

    Total Files

    11

    Last publish

    Collaborators

    • jamesdbloom