JSONResponse

# JSONResponse

Extends Helper

This helper allows performing assertions on JSON responses paired with following helpers:

  • REST
  • GraphQL
  • Playwright

It can check status codes, response data, response structure.

# Configuration

  • requestHelper - a helper which will perform requests. REST by default, also Playwright or GraphQL can be used. Custom helpers must have onResponse hook in their config, which will be executed when request is performed.

# Examples

Zero-configuration when paired with REST:

// inside codecept.conf.js
{
  helpers: {
    REST: {
      endpoint: 'http://site.com/api',
    },
    JSONResponse: {}
  }
}

Explicitly setting request helper if you use makeApiRequest of Playwright to perform requests and not paired REST:

// inside codecept.conf.js
// ...
  helpers: {
    Playwright: {
      url: 'https://localhost',
      browser: 'chromium',
    },
    JSONResponse: {
      requestHelper: 'Playwright',
    }
  }

# Access From Helpers

If you plan to add custom assertions it is recommended to create a helper that will retrieve response object from JSONResponse:

// inside custom helper
const response = this.helpers.JSONResponse.response;

# Methods

# Parameters

  • config

# dontSeeResponseCodeIs

Checks that response code is not equal to the provided one

I.dontSeeResponseCodeIs(500);

# Parameters

# dontSeeResponseContainsJson

Checks for deep inclusion of a provided json in a response data.

// response.data == { data: { user: 1 } }

I.dontSeeResponseContainsJson({ user: 2 });

If an array is received, checks that no element of array contains json:

// response.data == [{ user: 1 }, { user: 3 }]

I.dontSeeResponseContainsJson({ user: 2 });

# Parameters

# seeResponseCodeIs

Checks that response code is equal to the provided one

I.seeResponseCodeIs(200);

# Parameters

# seeResponseCodeIsClientError

Checks that the response code is 4xx

# seeResponseCodeIsRedirection

Checks that the response code is 3xx

# seeResponseCodeIsServerError

Checks that the response code is 5xx

# seeResponseCodeIsSuccessful

Checks that the response code is 2xx Use it instead of seeResponseCodeIs(200) if server can return 204 instead.

I.seeResponseCodeIsSuccessful();

# seeResponseContainsJson

Checks for deep inclusion of a provided json in a response data.

// response.data == { user: { name: 'jon', email: '[email protected]' } }

I.seeResponseContainsJson({ user: { email: '[email protected]' } });

If an array is received, checks that at least one element contains JSON

// response.data == [{ user: { name: 'jon', email: '[email protected]' } }]

I.seeResponseContainsJson({ user: { email: '[email protected]' } });

# Parameters

# seeResponseContainsKeys

Checks for deep inclusion of a provided json in a response data.

// response.data == { user: { name: 'jon', email: '[email protected]' } }

I.seeResponseContainsKeys(['user']);

If an array is received, check is performed for each element of array:

// response.data == [{ user: 'jon' }, { user: 'matt'}]

I.seeResponseContainsKeys(['user']);

# Parameters

# seeResponseEquals

Checks that response data equals to expected:

// response.data is { error: 'Not allowed' }

I.seeResponseEquals({ error: 'Not allowed' })

# Parameters

# seeResponseMatchesJsonSchema

Validates JSON structure of response using joi library (opens new window). See joi API (opens new window) for complete reference on usage.

Use pre-initialized joi instance by passing function callback:

// response.data is { name: 'jon', id: 1 }

I.seeResponseMatchesJsonSchema(joi => {
  return joi.object({
    name: joi.string();
    id: joi.number();
  })
});

// or pass a valid schema
const joi = require('joi);

I.seeResponseMatchesJsonSchema(joi.object({
  name: joi.string();
  id: joi.number();
});

# Parameters

  • fnOrSchema any

# seeResponseValidByCallback

Executes a callback function passing in response object and chai assertions with expect Use it to perform custom checks of response data

I.seeResponseValidByCallback(({ data, status, expect }) => {
  expect(status).to.eql(200);
  expect(data).keys.to.include(['user', 'company']);
});

# Parameters

Last Updated: 7/12/2022, 1:16:43 AM