codeceptjs-httpmock

codeceptjs-httpmock is CodeceptJS helper which wraps mockttp library to manage http mock in tests.

NPM package: https://www.npmjs.com/package/codeceptjs-httpmock

Configuration

This helper should be configured in codecept.json/codecept.conf.js

• port: mock port. Default 9037
• debug: - (optional) enable debug logs. Default false

Example:

{
   "helpers": {
     "HTTPMock" : {
       "require": "codeceptjs-httpmock",
       "debug": false,
       "port": 9037
     }
   }
}

respondWith

Set up mock for method и urlPath. Response calculates in callback function.

  I.respondWith('POST', '/url', (req) => {
    if (req.body.status === 'good') {
      return { status: 200, body: '{"Status":"OK"}', headers: { 'Content-Type': 'application/json' } };
    }
    return { status: 400, body: { error: 'badman' } }
  });

Parameters

• method - request method
• urlPath - relative path for mock
• callback - (optional) callback function. Should return response object
• ctx - (optional) mockttp context

expectRequestUntil

Validates that request comes for method and urlpath that satisfies predicate function

I.expectRequestUntil('POST', '/myPath', req =>
    req.body.json.param === 'myValue'
  );

Parameters

• method - request method
• urlPath - relative path for mock
• predicate - (optional) specify predicate function. Predicate function should return true value.
• timeout - (optional) timeout in ms. After the end of the timeout method will throw Error

dontExpectRequestUntil

Validates that no request comes for method and urlpath that satisfies predicate function

I.dontExpectRequestUntil('POST', '/myPath', req =>
    req.body.json.param === 'myValue'
  );

Parameters

• method - request method
• urlPath - relative path for mock
• predicate - (optional) specify predicate function. Predicate function should return false value.
• timeout - (optional) timeout in ms. After this timeout helper will check that there were no requests

grabServerRequests

Get requests that comes to mock server by method and urlPath

let requests = await I.grabServerRequests('POST', '/myPath');

Parameters

• method - request method
• urlPath - relative path for mock