Plato - src/http/mock.js

/**
 * @file HTTP mocking
 * @since 0.2.2
 */
/*#ifndef(UMD)*/
"use strict";
/*global _GPF_START*/ // 0
/*global _gpfArrayTail*/ // [].slice.call(,1)
/*global _gpfHost*/ // Host type
/*global _gpfHttpSetRequestImplIf*/ // Set the http request implementation if the host matches
/*#endif*/

/**
 * Mocked response callback
 *
 * @callback gpf.typedef.mockedResponseCallback
 *
 * @param {gpf.typedef.httpRequestSettings} HTTP request settings
 * @param {...String} captured Regular expression capturing group values
 * @return {Promise<gpf.typedef.httpRequestResponse>|undefined}
 * @since 0.2.2
 */

/**
 * Definition of a mocked request
 *
 * @typedef gpf.typedef.mockedRequest
 * @property {gpf.http.methods} method HTTP method to mock
 * @property {RegExp} url Regular expression matching the URL to mock
 * @property {gpf.typedef.mockedResponseCallback} response Function that generates response when mocking applies
 * @since 0.2.2
 */

/**
 * Mocked request identifier
 *
 * @typedef gpf.typedef.mockedRequestID
 * @since 0.2.2
 */

/**
 * Maps request method to an array of mocked requests
 *
 * @type {Object}
 * @since 0.2.2
 */
var _gpfHttpMockedRequests;

/**
 * Match the provided request with the mocked one
 *
 * @param {gpf.typedef.mockedRequest} mockedRequest Mocked request to match
 * @param {gpf.typedef.httpRequestSettings} request Request to match
 * @return {Promise<gpf.typedef.httpRequestResponse>|undefined} undefined if not matching
 * @since 0.2.2
 */
function _gpfHttMockMatchRequest (mockedRequest, request) {
    var url = mockedRequest.url,
        match;
    url.lastIndex = 0;
    match = url.exec(request.url);
    if (match) {
        return mockedRequest.response.apply(mockedRequest, [request].concat(_gpfArrayTail(match)));
    }
}

/**
 * Match the provided request to the list of mocked ones
 *
 * @param {gpf.typedef.mockedRequest[]} mockedRequests List of mocked requests for the given method
 * @param {gpf.typedef.httpRequestSettings} request Request to match
 * @return {Promise<gpf.typedef.httpRequestResponse>|undefined} undefined if no mocked request matches
 * @since 0.2.2
 */
function _gpfHttMockMatch (mockedRequests, request) {
    var result;
    mockedRequests.every(function (mockedRequest) {
        result = _gpfHttMockMatchRequest(mockedRequest, request);
        return result === undefined;
    });
    return result;
}

function _gpfHttpMockGetMockedRequests (method) {
    if (!_gpfHttpMockedRequests[method]) {
        _gpfHttpMockedRequests[method] = [];
    }
    return _gpfHttpMockedRequests[method];
}

/**
 * Check if the provided request match any of the mocked one
 *
 * @param {gpf.typedef.httpRequestSettings} request Request to check
 * @return {Promise<gpf.typedef.httpRequestResponse>|undefined} undefined if no mocked request matches
 * @since 0.2.2
 */
function _gpfHttpMockCheck (request) {
    return _gpfHttMockMatch(_gpfHttpMockGetMockedRequests(request.method.toUpperCase()), request);
}

var _gpfHttpMockLastId = 0;

/**
 * Add a mocked request
 *
 * @param {gpf.typedef.mockedRequest} definition Mocked request definition
 * @return {gpf.typedef.mockedRequestID} Mocked request identifier, to be used with {@link gpf.http.mock.remove}
 * @see gpf.http
 * @since 0.2.2
 */
function _gpfHttpMockAdd (definition) {
    var method = definition.method.toUpperCase(),
        id = method + "." + _gpfHttpMockLastId++;
    _gpfHttpMockGetMockedRequests(method).unshift(Object.assign({
        id: id
    }, definition));
    return id;
}

/**
 * Removes a mocked request
 *
 * @param {gpf.typedef.mockedRequestID} id Mocked request identifier returned by {@link gpf.http.mock}
 * @since 0.2.2
 */
function _gpfHttpMockRemove (id) {
    var method = id.substring(_GPF_START, id.indexOf("."));
    _gpfHttpMockedRequests[method] = _gpfHttpMockGetMockedRequests(method).filter(function (mockedRequest) {
        return mockedRequest.id !== id;
    });
}

/**
 * Clears all mocked requests
 * @since 0.2.2
 */
function _gpfHttpMockReset () {
    _gpfHttpMockedRequests = {};
}

_gpfHttpMockReset();

/**
 * @gpf:sameas _gpfHttpMockAdd
 * @since 0.2.2
 */
gpf.http.mock = _gpfHttpMockAdd;

/**
 * @gpf:sameas _gpfHttpMockRemove
 * @since 0.2.2
 */
gpf.http.mock.remove = _gpfHttpMockRemove;

/**
 * @gpf:sameas _gpfHttpMockReset
 * @since 0.2.2
 */
gpf.http.mock.reset = _gpfHttpMockReset;

// Hook the mocking algorithm on top of host specific implementation

var _gpfHttpMockRequestImpl;

_gpfHttpMockRequestImpl = _gpfHttpSetRequestImplIf(_gpfHost, _gpfHttpMockImpl);

src/http/mock.js

Maintainability

Lines of code

Difficulty

Estimated Errors

Function weight

By Complexity

By SLOC